73 X.21 Library 


73 X.21 Library 

The Test Interface Module (TIM) located in the rear of the INTERVIEW determines the 
leads available for monitoring and control (Section 12). The variables and routines in this 
section apply to the X.21 interface module. RS-232, V.35, and RS-449 modules are treated 
in Section 63. 

To use the C variables and routines explained in this section, you must select Buffer Control 
Leads; H|S; on the FEB Setup menu. See Section 9.1(B). If no other source for clock is 
provided, use internal clock (Line Setup menu). Finally, load in the X.21 package via the 
Layer Setup screen. 

The variables and routines approximate X.21 Layer 1 spreadsheet-generated conditions and 
actions. Their use on the Protocol Spreadsheet is not limited to any particular layer, though 
normally they belong at Layer 1. Refer to Section 35 for more detailed explanations of the 
purposes of specific conditions and actions. Sometimes the name of the variable or routine is 
sufficient for identifying its related spreadsheet token. When this is not the case, the 
information is provided below. 

73.1 Structures 

Use the structure xmitjist, shown in Table 73-1, when transmitting line data via the 
x21 Jransmit_call routine. Refer to x21 Jransmitjcall in Section 73.3(A) for an 
example of how to use this structure. 

Table 73-1 
X.21 Structures 


Type 

Variable 

Value (hex/decimal) 

Meaning 

Structure Name: xmlt list 


Structure of a transmit list for x21_(ransmlt_call 
routine. Declared as type struct. Declared 
automatically If a softkey-entered 
CALL_SETUP_SEND action is taken. Reference 
member variables of the structure as follows: 
xmitjist. strlngjength 

unsigned char * 

string 


pointer to the location of the transmit string— the 
transmit string Is declared separately 

unsigned short 

strlngjength 

0-flfll0-6 5535 

length of the transmit string 
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73.2 Variables 

With an X.21 TIM installed, you may monitor the T and R data leads, the C and I 
control leads, and UA. See Table 73-2. 

The fast-event variable fevar_eia_changed detects a change in leads. It does not 
establish which lead(s) has changed, nor the validity of the lead’s status. Two 
associated status variables, current jeiajeads and previous _eia_leads, indicate the 
condition of the leads. These are two-byte (short) variables. Each lead is 
represented by a different bit in the short. Table 73-2 provides the mask that can be 
used to isolate each lead. 

Other bits in these variables monitor the validity of lead status, For the status of a 
lead to be considered valid in X.21, the lead must be stable for a minimum of 16 
bit-times. Each lead’s valid status is indicated by a separate bit in current _eia_leads 
and previous_eia_leads . Again, refer to Table 73-2. 

Whenever a lead changes, the value in current_eiajeads is written to 
previous_eia_leads . Then current jeiajeads is updated. 

(A) Masking To Detect a Change in a Given Lead 

To test whether or not a given lead changed, I for example, while disregarding 
its status, enter the following condition on the Protocol Spreadsheet; 

CONDITIONS: 

< 

fevar_eia_changed <&& (((current jeiajeads “ previousjeiajeads) <6 0x40) == 0x40 ) 

) 

Select a mask value from the list in Table 73-2 to indicate which lead you care 
about. Specify multiple leads with a mask derived via hexadecimal addition. 

The mask for I is 0x40. In the example, the event fevar_eia_changed updated 
currentjeiajeads. The new current jeiajeads was bitwise-exclusive-ORed with 
previous_eia_leads to identify all the leads that changed. Then the result was 
bitwise ANDed with the I mask to determine if I was among the leads that 
changed. If this result was equal to the mask, the lead changed. 

Following the evaluation of the condition, previous_eia_leads was updated to 
match current eia leads. 
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Table 73-2 
X.21 Variables 


Type 


Variable Value (hex/decimal) Meaning 


extern fast_event fevar_ela_changed True when the status changes 

for an EIA lead. Line Setup 
configured for emulate or 
monitor mode. 

extern const volatile unsigned short current_ela_leads 1 C-valld 

2 B (RS-232 mapping Is SQ) 

4 l-valld (Rl) 

8 R-valld (DSR) 

10/16 T -valid (DTR) 

40/64 I (CTS) 

80/128 C (RTS) 

100/256 R (RD) 

200/512 UA 

400/1024 T (TD) 

A value In this list indicates 
which lead(s) you care about. 
When ande d (&) with 
cur rent jaiajeads, the result 
equals zero if the lead Is on (or 
the mask If the lead Is oft). For 
validity checks, the result of 
ending with currentjeiajeads 
equals the mask for valid (or 
zero for invalid). 

Examples : 

STATE: c_on_and_vatld 
{ If ( (current_ela_leads & 0x81) 
== 1 ) sound_alarm() ; } 

STATE: c_off_and_valld 
{ if ( (currentjelajeads & 0x81) 
== 0x81) sound_alarm(); } 

Note: This variable will store EIA 
status If (1) Internal or external 
clock Is supplied, (2) EIA leads 
are enabled on FEB Setup, and 
(3) fevar_ela_changed has 
updated the leads. Line Setup 
configured for emulate or 
monitor mode. 

extern const volatile unsigned short prevlous_elaJeads Same values as 

currentjelajeads. Updated 
when leads change, but only 
after logic has had a chance to 
compare current and previous 
leads. Line Setup configured 
for emulate or monitor mode. 
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(B) Masking For the Status or Validity of a Lead 

You may also test the current status or validity of a lead, independent of any 
change. If a mask testing for status is ande d with current jeiajeads, zero will 
mean that the lead in on. If the result equals the mask, the lead is off. If a 
mask testing for validity is ande d with current jeiajeads, the lead status is valid 
when the result equals the mask. If the result is zero, the status is invalid. 

To test for both status and validity, derive a mask via hexadecimal addition. 

And the mask with current _eia_leads, as in this if statement testing for I “on” 
and valid: 

STATE: test for t on and_valld 

{ 

if ({current eia_leads A 0x44) == 4) sound alarm(); 

> 

(C) Detect Change and Current Status 

The two examples shown above could be combined to test for I changing from 
off to valid on: 

CONDITIONS: 

{ 

(fevar_eia_changed AA (((current _eia_leads " previous_eia_leads) A 0x40) == 0x40) AA 
(( current_eia leads A 0x44) == 4)) 

} 

This example approximates the translator’s version of the spreadsheet-token 
condition LEADS I V-ON when it appears alone in a conditions block. When a 
LEADS condition is combined with another condition, in most cases the other 
condition will supply the event variable and only the lead status test will be used. 

73.3 Routines 

(A) Control and Transmit 

Use the following routines in emulate mode only. If you try to call one of these 
routines in monitor mode, you may be returned to the main program menu. 
When you go to the Protocol Spreadsheet and search for errors, a message like 
the following may be displayed: " Error 140: Unresolved reference ctl_eia." 

ctl_eia 

Synopsis 

extern void ctl_eia(on_mask, off_mask); 
unsigned short on_mask ; 
unsigned short offjnask; 
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Description 

The ctl_eia routine allows you to control the status of the two X.21 control- 
leads. Which lead you control depends on your emulation mode. When the 
Line Setup menu shows Mode: you control I. An d£M&ATgc>Tr 

selection gives you control over C. The softkey equivalent of this routine is the 
LEADS action on the Protocol Spreadsheet. 

Inputs 

The first parameter indicates which lead you want to turn on. One bit in the 
parameter controls a given lead: I (01) and C (04). Wherever there is a zero 
in the first parameter, the corresponding lead will be turned on. A one in this 
parameter will not cause any lead to be turned off. A value of Oxff will mean 
don't care (no action). 

The second parameter indicates which lead you want in the "off” condition. 
One bit in the parameter controls a given lead: I (01) and C (04). Wherever 
there is a one in the second parameter, the corresponding lead will be turned 
off. Zeroes in this parameter do not turn leads on. A value of 0 will mean 
don't care (no action). 


NOTE: If both bytes are attempting to control the same lead, the 
off parameter will override the on parameter. 


Examp le 

Suppose your emulate mode is . As a DCE, you control the I lead. 

(An attempt to control the status of C will fail, since the DTE controls this 
lead.) When C is raised, you want to turn I on; when C drops, turn I off. 


LAYER: 1 

STATE: controlj 

CONDITIONS: LEADS C ON 
ACTIONS: 

{ 

ctl_eia(Oxfe, 0x00); 

} 

CONDITIONS: LEADS C OFF 
ACTIONS: 

{ 

cll_eia(Oxff, 0x01); 

) 
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( 


x21Jdle_action 

Synopsis 

extern void x21Jdle_action(characler); 
unsigned char character; 


Description 

Only for format SYNC, the x21 Jdlejaction routine allows you to change the 
idle-line condition applied by the INTERVIEW. A LEADS R BELLS action, for 
example, requires the x21 Jransmiljcall routine in addition to x21 Jdlejaction. 

Inputs 

The only parameter is a character or numeric value representing the idle 
character. 


Example 

To signal an incoming call, you would use the x21 _transmit_call routine to send 
the sync pattern. Then you would use the x21 Jdlejaction routine to send an 
idle string of bells : 

LAYER: 1 

{ 

unsigned char syncs (J = {0x16,0x16); 
struct xmltjlst 
{ 

unsigned char * string; 
unsigned short stringjength; 

>; 

struct xmitjlst sendjtring [] = {&syncs(OJ, 2); 

) 

STATE: slgna1_lncomlng_oall 
CONDITIONS: KEYBOARD “ ’ 

ACTIONS: 

{ 

x21jransmil_call(l, &send_string[0], 0); 
x21 idle actionf * L *>; 

} 


( 
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x21_transmit_call 

Synopsis 

extern void x21jransmtt_call(counl, struct jend_string_ptr, xmitjag); 
unsigned short count; 
struct xmitjist 
< 

char * string_ptr; 
unsigned short stringjength; 

); 

struct xmitjist * struct _send_string_ptr; 
unsigned short xmil_tag; 


P eS Cri ptip n 

The x21 jtransmit _caU routine sends a specified data string in call-setup mode. 
The softkey equivalent of this routine is the CALL_SETUP_SEND action. 


Inp ut s 

The first parameter is the number of strings to be sent. 

The second parameter is a pointer to a structure which in turn identifies the 
location and length of each string. 

The third parameter is a transmit tag. In other contexts it identifies the type of 
BCC to be sent. In X.21, however, no BCC is sent from Layer 1. The value of 
this parameter should be zero. 


Example 

Assume you are emulating a DTE. To send a call request in call-setup mode, 
enter the following spreadsheet program: 


LAYER: 1 


{ 

unsigned char syncs [j = {0x16,0x16); 
unsigned char number [) - “ 1234567"; 
unsigned char end [] = 

Struct xmitjist 

{ 

unsigned char * string; 
unsigned short stringjength; 

}; 

struct xmlt list send_string {] = { &syncs(OJ , 

) 


2, &number[OI, slzeof (number) - /, Jcend(O), 1); 
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STATE: send 

CONDITIONS: RECEIVE STRING *d]++’ 

ACTIONS: 

{ 

x2l transmit _caU (3, <&send_string(0], 0); 

} 

Notice in the preceding example that sync characters were sent in the same call 
to x2l _transmii_call that sent the called number, The equivalent 
softkey-generated action is LEADS T DATA CALL_SETUP_S£ND “^1234567+”. 

x21_transmit_calljdle 

Syn o ps is 

extern void x21_transmil_call_idle(count, struct_send_strlng_ptr, xmlt_tag, new_ldle); 
unsigned short count; 
struct xmlt list 
{ 

char * string_ptr; 
unsigned short string_lenglh; 

); 

struct xmltjist * struct _send_siring_ptr; 
unsigned short xmit_tag; 
unsigned char newjdle; 

Description ' 

The x21 _transmit_call_idle routine sends a data string in call-setup mode and 
includes a specified idle character. The softkey equivalent of this routine is the 
CALL_SETUP SENDJDLE action. This routine differs from x21 _transmit_call in 
that a change in idle character is guaranteed to occur during the transmission. 

Inputs 

The first parameter is the number of strings to be sent. 

The second parameter is a pointer to a structure which in turn identifies the 
location and length of each string. 

The third parameter is a transmit tag. In other contexts it identifies the type of 
BCC to be sent. In X.21, however, no BCC is sent from Layer 1. The value of 
this parameter should be zero. 

The fourth parameter is the idle character. Enter the idle character as a 
decimal or hexadecimal value, or as a character enclosed by single quotes ("). 

Example 

This example is the same as the one for x2 1 _transmit_call except that here the 
idle character, +, is included in the call to x21 jransmit _call_idle . 
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LAYER: 1 

{ 

unsigned char syncs [] = {0x16,0x16); 
unsigned char number [) = "1234567"; 
struct xmitjist 
{ 

unsigned char * string; 
unsigned short stringjength; 

}; 

struct xmitjist send_string [] = { dcsyncs(O ) , 2, &number[0], sizeof (number) - /); 

) 

STATE: send 

CONDITIONS: RECEIVE STRING HJ++’ 

ACTIONS: 

{ 

x21jransmit calljdle(2, &send_string[0 ), 0, 0x2b); 

) 

Notice in the example that sync characters were sent in the same call to 
x21 jransmit_call_idle that sent the called number. The equivalent 
softkey-generated action is CALL_SETUP_SEND_IDLE 1234567" NEWJDLE “ + 


set_tcr_b 

Synopsis 

extern void setjcr_b (tcrjegister_mask, tcr_register_vaiue); 
unsigned char tcr_register_mask; 
unsigned char tcr_register_value; 

Description 

This routine clamps the transmit line to 0 (space) or 1 (mark), or unclamps it so 
that transmit routines may be executed, In X.21, steady zero will signal a clear 
request/indication or a clear confirm, while steady 1 will indicate one of the 
call-ready or call-setup states. 

The X.21 softkey actions that are built on this routine are LEADS R (T) one, 
LEADS R (T) ZERO, and LEADS R (T) DATA. In other contexts, the routine simply 
initiates and terminates a break . 

Inputs 

The first parameter is the mask that is ande d with the current TCR register to 
turn the current values of bits 3 and 4 (counting 1-8 from the right) to zero. 

This mask is always 0xf3. 

The second parameter contains the new values of bits 3 and 4 that will be 
written to the register. The three available parameters are 0x08 to clamp the line 
to zero, 0x0c to clamp the line to 1, and 0x04 to unclamp the line and permit 
data transmissions. 
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Example 

Assume you are emulating a DTE. To indicate a clear confirmation, enter the 
following spreadsheet program: 

LAYER: 1 
STATE: 

CONDITIONS: KEYBOARD ■ " 

ACTIONS: 

{ 

setjcr_b (0xf3, 0x08); 
ci!_tia(0xjf, 0x04); 

} 


The equivalent softkey-generated action is LEADS T ZERO c OFF. 


(B) Phase 

The following routines are valid in either emulate or monitor mode. 


enter_call_phase 

Synopsis 

extern void enierjcall _phase( ); 

Descri p ti on 

During the call-establishment phase, this routine overrides existing selections on 
the Line Setup menu with ASCII code, 7-bit odd parity, and SYNC format. 

Example 

When a lead changes, look for these conditions: T and R on (space), C and I 
off, and all leads valid. If conditions are true, enter call phase. 

{ 

extern fast_event fevar_ela_changed; 

extern const volatile unsigned short current eia leads; 

) 

LAYER: 1 

ST ATE : look_for_change_to_call_phase 
CONDITIONS: 

{ 

fevar_ela changed && ((currenl_eia leads A OxSdd) =- Oxdd) 

) 

ACTIONS: 

{ 

enterjcall _phase( ); 

) 
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enter_data_phase 

S yno psis 

extern void enter_data jhaseQ; 

Description 

During the data-transfer phase, this routine implements existing selections on the 
Line Setup menu. 

Example 

When a lead changes, look for these conditions: T and R off (mark), C and I 
on, and all leads valid. If conditions are true, enter data phase. 

{ 

extern fastjevent fevar_eia_changed; 

extern const volatile unsigned short current ela leads; 

) 

LAYER: 1 

STATE: look_for_change_to_data_phase 
CONDITIONS: 

< 

fevarjeia_changed && ((current _eia_!eads £ OxSdd ) == 0x5 Id) 

) 

ACTIONS: 

1 

enter_data _phase(); 

) 
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74 X.25 Layer 2 Library 

When the X.2S Layer 2 package is loaded in via the Layer Setup screen, the following 
external routines and variables become available for use by the programmer. Their use on 
the Protocol Spreadsheet is not limited to any particular layer, though normally they belong at 
Layer 2. 

The variables and routines approximate X.25 Layer 2 spreadsheet-generated conditions and 
actions. Refer to Section 36 for more detailed explanations of the purposes of specific 
conditions and actions. Sometimes the name of the variable or routine is sufficient for 
identifying its related spreadsheet token. When this is not the case, the information is 
provided below. 

74.1 Structures 

The structure send _Jrame_slructure defines the format of transmitted X.25 frames. 

See Table 74-1. Use this structure to send frames via the send _frame routine in 
emulate mode. See Section 74.3(B). Each variable in the structure relates to some 
softkey selection or user entry in the SEND action. 

74.2 Variables 

(A) Monitoring Events 

1. Emulate or monitor mode. X.25 Layer 2 events include frames detected, 
good or bad BCC’s, and aborts. All event variables in Table 74-2 containing 
a dte_ or dce_ prefix are valid in either emulate or monitor mode. These 
event variables are die Jrame, dee Jrame, die _good_bcc, dce_good_bcc, 
dte_bad_bcc, dce_bad_bcc, dte_abort, dce_abort. The variable 
dce_good_bcc , for example, equates to DCE gdbcc, 

You can use both die and dee variables relating to the same event in one 
conditions block. Suppose you want to count all bad BCC’s from either side 
of the line. Enter the following CONDITIONS/ACTIONS block: 

CONDITIONS: 

{ 

dte_bad_bcc \ \ dce_bad_bcc 

) 

ACTIONS: COUNTER badjbcc INC 
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Table 74-1 

X.25 Layer 2 Structures 


Type 

Variable 

Value (hex/decimal) 

Meaning 



send_frame_structure 


Structure of a frame In X.25. Declared as type 
struct. Declared automatically If a 
softkey-entered SEND action Is taken. Program 
frames assigned to structure as follows: struct 
send_frame_struoture name. Reference a 
structure variable as follows: name . be c type. If 
values In the frame structure are not Initialized by 
the user, they default to 0. You may Initialize the 
values when the structure Is declared: 
struct send_frame_structure name = {1, 1, 1,0, 
1,1,3, 0x71, 3. 0}; 



l 
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Table 74-2 

X.25 Layer 2 Variables 


Type 


Variable Value (hex/decimal) Meaning 


extern event 

extern event 

extern event 

extern event 

extern event 

extern event 

extern event 

extern event 

extern event 
extern event 

extern event 

extern event 

extern event 

extern event 


6te_frame 

dceframe 

dte_good_bcc 

dce_good_bcc 

dte_bad_bcc 

dce_bad_bcc 

dte_abort 

dce_abdrt 

rcvd_frame 

lnvalld_frame 

12 T 1 

bccerror 

nr_error 

ns error 


True when a DTE frame Is 
detected. Line Setup 
configured for emulate or 
monitor mode . 

True when a DCE frame Is 
detected. Line Setup 
configured for emulate or 
monitor mode. 

True when a good BCC Is 
calculated for a DTE frame. 

Line Setup configured for 
emulate or monitor mode. 

True when a good BCC Is 
calculated for a DCE frame. 

Line Setup configured for 
emulate or monitor mode. 

True when a bad BCC Is 
calculated for a DTE frame. 

Line Setup configured for 
emulate or monitor mode. 

True when a bad BCC Is 
calculated for a DCE frame. 

Line Setup configured for 
emulate or monitor mode. 

True when an abort Is detected 
for a DTE frame. Line Setup 
configured for emulate or 
monitor mode. 

True when an abort Is detected 
for a DCE frame. Line Setup 
configured for emulate or 
monitor mode. 

True when a frame Is received. 
Line Setup configured for 
emulate mode only. 

True when an Invalid frame Is 
detected. Line Setup 
configured for emulate mode 
only. 

True when the T1 tlmeout-tlmer 
has expired. Line Setup 
configured for emulate mode 
only. 

True when a BCC error Is 
detected. Line Setup 
configured for emulate mode 
only. 

True when an N(R) error Is 
detected In a received INFO or 
supervisory frame. Line Setup 
configured for emulate mode 
only. 

True when an N(S) error Is 
detected In a received INFO 
frame. Line Setup configured 
for emulate mode only. 
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Table 74-2 (continued) 


Type 


Variable Value (hex/decimal) Meaning 


extern event 

extern volatile const unsigned char 

extern volatile const unsigned char 
extern volatile const unsigned char 
extern volatile const unsigned char 

extern volatile const unsigned char 

extern volatile const unsigned char 
extern volatile const unsigned char 


extern volatile const unsigned char 
extern volatile const unsigned char 

extern volatile const unsigned ohar 


extern volatile const unsigned char 


frame_sent 

m_frame_addr 

m_frame_type 

m_frame_cntrl_byte_1 

m_frame_pf 

m_frame_bcc_type 


rcvd_frame_addr 


rcvd_frame_type 


rc vd_fram e_cntrl_by t e_1 
rcvd_frame_pf 

rovd_frame_bcc_type 


rcvd_frame_nr 


True when frame Is passed 
down to Layer 1 . Line Setup 
configured for emulate mode 
only. 

1 to DCE 

3 to DTE 

Line Setup configured for 
emulate or monitor mode. 
(same as rcvdJrame_type—Llne Setup 
configured lor emulate or monitor mode) 

(actual value of control byte— Line Setup 
configured for emulate or monitor mode) 


0 

pf=0 

10/16 

pf=1 


Line Setup configured for 
emulate or monitor mode. 

1 

good 

2 

bad 

3 

abort 


Line Setup configured for 
emulate or monitor mode. 

1 

to DCE 

3 

to DTE 


Line Setup configured for 
emulate mode only. 

0 

Info 

1 

rr 

5 

rnr 

9 

re| 

d/13 

srej 

2f/47 

sabm 

6f / 111 

sabme 

43/67 

disc 

f/1 5 

dm 

f/15 

sarm 

63/99 

ua 

67/135 

frmr 

ff/255 

other 

ff/255 

unknown 


Line Setup configured for 
emulate mode only. 

(actual value of control byte— Line Setup 
configured for emulate mode only) 

0 

pf=0 

10/16 

pf=1 


Line Setup configured for 
emulate mode only. 

1 

good 

2 

bad 

3 

abort 


Line Setup configured for 
emulate mode only. 

0-7 (MOD 8) 

Line Setup configured for 
emulate mode only. 
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Table 74-2 (continued) 


Type 

Variable 

Value (hex/decimal) Meaning 

extern volatile const unsigned char 

rcvdframens 

0-7 (MOD 8) 

Una Setup configured for 
emulate mode only. 

extern volatile unsigned short 

rcvd_f ramebuf f_s eg 


Inter-layer message buffer 
number (actually, an IAPX-286 
segment number) In a received 
frame. This segment number 
can be converted to a pointer 
by shifting It left 16 bits. Line 
Setup configured for emulate 
mode only. 

extern volatile unsigned short 

rc vd_frame_sdu_of f s et 


Offset to where the service data 
unit begins In an Inter-layer 
message buffer In a received 
frame. Add to buffer segment 
number (converted to pointer) 
to point to first byte In frame. 
Line Setup configured for 
emulate mode only. 

extern volatile unsigned short 

rcvd_frame_sdu_slze 


Size of service data unit In a 
received frame. Line Setup 
configured for emulate mode 
only. 

extern volatile unsigned short 

I2_ourrent_wlndow_edge 


When equal to upper edge, 
window Is full; when equal to 
lower edge, window Is empty; 
when not equal to upper edge, 
window Is not full; and when not 
equal to tower edge, window Is 
not empty. Line Setup 
configured for emulate mode 
only. 

extern volatile unsigned short 

I2_lower_wlndow_edge 


see l2_current_w!ndow__edge 

extern volatile unsigned short 

l2_upper_wlndow_edge 


see l2_current_wlndow_edge 

extern volatile unsigned short 

I2_resend_edge 


When resend edge Is not equal 
to lower window edge, there Is 
more to resend; when resend 
edge Is equal to lower window 
edge, there Is no more to 
resend. Line Setup configured 
for emulate mode only. 

extern unsigned char 

I2_enhance 

0 

1 

4 

5 
8 
9 

12/18 

normal 

reverse 

low 

reverse low 
blink 

reverse blink 
blink low 

Line Setup configured for 
emulate or monitor mode. 

extern unsigned char 

I2_suppress 

0 

1 

off 

on 

Line Setup configured for 
emulate or monitor mode. 
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Using spreadsheet tokens, the same test needs two CONDITIONS/ACTIONS 
blocks: 

CONDITIONS: DTE BD8CC 
ACTIONS; COUNTER bad_bco INC 
CONDITIONS: DCE BDBCC 
ACTIONS: COUNTER bad_bcc INC 

When the user selects DTE or DCE on the first rack of softkeys for Layer 2 
conditions, a second rack appears from which he must select a particular 
frame type. A DTE INFO condition, for example, when translated, includes 
two C variables, one event variable and one status variable: 

{ 

dte Jrame && (m _frame type == 0) 

> 

As a C programmer, you do not need to specify a frame type. To include 
all frames in a condition, use the event variable only: 

CONDITIONS: 

< 

die Jrame 

) 

f 

2. Emulate mode only. Some events may be detected in emulate mode only. ( 

The event variables are rcvd Jrame, invalid J'rame, I2_T1, bcc_error, 
nr_error, ns_error, and frame _sent. 

If you try to use one of these variables in monitor mode, you may be 
returned to the main program menu. When you go to the Protocol 
Spreadsheet and search for errors, a message like the following may be 
displayed: “ Error 140: Unresolved reference rcvd J'rame." 

When the user selects RCV on the first rack of softkeys for Layer 2 
conditions, a second rack appears from which he must select a particular 
frame type. When the translator converts a RCV INFO condition into C, it 
will include two C variables, one event variable and one status variable: 

{ 

rcvd Jrame && (rcvd Jramejype == 0 ) 

) 

The C programmer does not have to specify a frame type. To include all 
received frames in a condition, use the event variable only: 

CONDITIONS: 

{ 

rcvd Jrame 

} 

Error detecting may be accomplished via bcc_error, nr_error, ns_error, and 
invalid Jrame. These variables equate to the softkey tokens bearing similar 
names. ( 
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One of the emulate-mode variables monitors an emulate action. The event 
variable frame jsent will come true as soon as the frame has been passed to 
the layer below. Note that if Layer 1 is an X.21 protocol in call-setup 
phase, a frame that is “sent” at Layer 2 will stop at Layer 1 and will not be 
transmitted out onto the line. 


(B) Status Variables 

Status variables are those in Table 74-2 that do not include event in the Type 
column. Their associated, event variables, guarantee that they are updated and 
tested. 

The softkey-generated condition for received Info frames is Rev INFO. The C 
version of the same condition should look like this: 

CONDITIONS: 

{ 

rcvd Jrame &.& [rcvd Jrame type == 0) 

) 

1. Frame characteristics. All status variables in Table 74-2 containing an 
prefix are valid in either emulate or monitor mode: m Jrame jxddr, 

m Jramejype, m Jrame _cntrl Jyte J , mjrame j>f, and m Jrame _bccjype. 
Use these variables to monitor a particular address, frame type, control byte, 
P/F value, or BCC. 

All status variables in Table 74-2 containing a rcvd_ prefix are valid in 

emulate mode only: rcvd Jrame _addr , rcvd Jramejype, 

rcvd Jrame _cntrl_byte J , rcvd Jrame JrccJype, rcvd Jrame _pf, 

rcvd Jrame _nr, and rcvdjrame_ns. Use these variables to monitor a 

particular address, frame type, control byte, BCC, or P/F, N(R), or N(S) 

value. 

If you try to use an emulate-mode variable in monitor mode, you may be 
returned to the main program menu. When you go to the Protocol 
Spreadsheet and search for errors, a message like the following may be 
displayed: "Error 140: Unresolved reference rcvd Jrame jype.” 

2. Frame buffers. As BOP frames are received, they are automatically placed 
in IL message buffers to be passed up the layers. Three emulate-mode 
variables provide the user with access to the information in the frame that is 
located beyond the control byte. These variables are rcvd Jrame J>uff_seg, 
rcvd Jrame _sdu_offset , and rcvd Jrame _sdu_size. See Section 66.1 for a 
more detailed discussion of the buffer components to which these variables 
refer. 
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Make a pointer to an IL buffer by casting rcvd Jrame_buff_seg as a long, 
shifting it left sixteen bits, adding rcvd Jrame_sdu_offset , and casting the 
result to a pointer. Increment the pointer twice (thereby adding two to the 
offset) . 

< 

unsigned char * ptr; 

ptr = (void *)(((long)rcvd _frame_buff_seg « 16) + rcvd Jramt_sduj>ffse t ) ; 
ptr*=2; 

} 

It is now pointing at the first byte in the X.25 Layer 3 header. You may 
continue to move through the frame for its entire length, indicated in 
rcvd _framej$du_size. 


3. Transmit window. Four related variables test the status of the Layer 2 
window. The particular values of these variables at any given time is not 
significant. What is significant is how they compare to each other. The 
softkey status condition on the left makes the variable comparison on the 
right: 


WINDOW FULL 
WINDOW EMPTY 
WINDOW NOT_FULL 
WINDOW NOT_EMPTY 
MORE_TO_RESEND 
NO_MORE_TO_RESEND 


I2_current _window jsdge == !2_upper_wlndow_edge 
l2_currenl_window_edge == l2^Jower_window_edge 
l2_current_window_edge 1= l2_upper_window_edge 
l2_current_window_edge I- !2_Iower_window_edge 
I2_resend_edge 1= I2_lower_windowjedge 
12_resend_edge == l2_tower_window_edge 


{ 


(C) Controlling Protocol Trace Display 

To enhance or suppress particular frames on the Layer 2 Protocol Trace screen 
in emulate or monitor mode, assign a coded value to I2_enhance or I2_suppress. 
The values are listed in Table 74-2. To assign a value to either of these 
variables, place the statement in an ACTIONS block. For example, display RNR 
frames in reverse-video and suppress display of invalid frames: 

CONDITIONS: RCV RNR 
ACTIONS: 

1 

I2_enhance = 1; 

} ' 

CONDITIONS: RCV INVALID 
ACTIONS: 

{ 

I2_suppress = 1; 

) ' 


74-8 


JUL '90 




I 


74 X.25 Laver 2 Libra , 


Check the value of these display-control variables in a conditions block 

CONDITIONS; RCV INFO 

{ 

I2_enhance == 1 
) ' 

ACTIONS: 

{ 

I2_enhance = 0; 

} 

or an ACTIONS block: 

CONDITIONS: RCV INFO 
ACTIONS: 

{ 

if(l2jenhance == 1) 

I2_enhance = 0; 

} 


74.3 Routines 

Use the following routines in emulate mode only. If you try to call one of these 
routines in monitor mode, you may be returned to the main program menu. When 
you go to the Protocol Spreadsheet and search for errors, a message like the 
following may be displayed: " Error 140: Unresolved reference 12 _jive_data." 

(A) Receive 
I2_give_data 

Synopsis 

extern void I2_give_data(); 


The I2_give_data routine takes an interlayer message buffer associated with a 
received INFO frame, changes the SDU offset to point to higher-level data, and 
sends a DL_DATA IND primitive up to Layer 3 along with a reference to this 
buffer. The softkey equivalent of this routine is the GVDATA action on the 
Protocol Spreadsheet. 

Example 

Layer 3 wants access to the line in order to receive and send data. Assuming 
X.25 personality packages are loaded at Layers 2 and 3, enter the following 
program: 
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LAVER: 2 

STATE: datallnk 

CONDITIONS: DL CONNECT REQ 
ACTIONS: DL_CONNECT CONF 
CONDITIONS: DL_DATA REQ 
ACTIONS: SEND INFO “((DL_DATA)) ’ 
CONDITIONS: RCV INFO 
ACTIONS: 

{ 

12 _jlve_d<Ua(); 

> 


(B) Transmit 
resend_frame 

Synopsis 

extern void resend _Jrame(pf, first_or_next); 
unsigned char pf; 
unsigned char first _or_n ext ; 


Description 

The resend Jrame routine will set the P/F bit to a specified value and resend 
either the first or next frame in the window. The softkey equivalent of this 
routine is the (PROTOCL) resend action on the Protocol Spreadsheet. 

Inputs 

The first parameter is the value of the P/F bit in the frame. It may be set to 
either 0 or 1. 

The second parameter indicates whether the first frame in the window will be 
sent, or whether the next frame in the window will be sent. The first resend 
action will send the first frame in the window regardless of whether first or ( next 
has been selected. Legal entries are 0 (first) or 1 (next). 

Example 

Suppose you want to resend the entire transmit window if you receive a REJ 
frame. 

LAVER: 2 

STATE: xfer 

/* Whatever conditions and actions send data precede the following condition. */ 

CONDITIONS: RCV REJ RESP 
NEXT STATE: recover 
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STATE: recover 

CONDITIONS: ENTER_STATE 
ACTIONS: 

{ 

resend _frame(l, 0); 

) 

CONDITIONS: FRAME_SENT 
MORE_TO RESEND 
ACTIONS: 

{ 

resend Jrame(l.l); 

} 

CONDITIONS: FRAME_SENT 
NO_MORE„TO_RESEND 
NEXT STATE: xfer 


reset_nr 

Synopsis 

extern void reset_nr(); 

Description 

This routine resets the N(R) field in information and supervisory frames to zero. 
The softkey equivalent of this routine is the (PROTOCL) RSET_NR action on the 
Protocol Spreadsheet. 

Example 

When a link is established, reset N(R). 

LAYER: 2 

STATE: reset 

CONDITIONS: ENTER_STATE 
ACTIONS: SEND SABM 
CONDITIONS: RCV UA 
ACTIONS: 

{ 

reset _nr(); 

} 

reset_ns 

S yno psis 

extern void reset _ns(); 

Description 

The N(S) field in information frames is reset to zero and the transmit window is 
cleared. The softkey equivalent of this routine is the (PROTOCL! RSET_NS action 
on the Protocol Spreadsheet. 
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Example 

When a link is established, reset N(S). 

LAYER: 2 

STATE: reset 

CONDITIONS: ENTER_STATE 
ACTIONS: SEND SABM 
CONDITIONS: RCV UA 
ACTIONS: 

{ 

reset _ns(); 

) 


send_frame 

Synopsis 

extern void sendjrame(il_bufjer_number, relay _baton, data_start_offset, transmit Jrame _ptr); 
unsigned short il_buffer_number; 
unsigned short relay_balon; 
unsigned short data_siart_offset; 
struct send_frame_structure 
{ 

unsigned char addrjype; 
unsigned char frame_type; 
unsigned char nrjtype; 
unsigned char ns_type; 
unsigned char p _J_type; 
unsigned char bccjype; 
unsigned char addrjvalue; 
unsigned char cntrl_byle; 
unsigned char nr_value; 
unsigned char ns value; 

}; 

struct send _frame_structure * transmit^frame _ptr; 


Description 

The send Jrame routine adds a frame-level header to an interlayer message 
buffer and passes the buffer to Layer 1. The softkey equivalent of this routine is 
the SEND action on the Protocol Spreadsheet. 

Inputs 

The first parameter is the interlayer message buffer number. See Section 
66.3(A), Layer-Independent OSI routines. 

The second parameter is the maintain bit used to hold the buffer while the send 
operation is being performed. See Section 66.3(A). 

The third parameter is the offset from the beginning of the buffer to the start of 
the service data unit. See Section 66.3(A). 
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The fourth parameter is a pointer to the frame structure to be sent. For a 
description of send Jrame ^structure , see Table 74-1.. 

Example 

Send an Info frame containing a canned fox message and a good BCC onto the 
line. 

{ 

static unsigned short ll_buffer_number; 
sialic unsigned short relay_baton; 
static unsigned short datastart_offset; 
struct send Jrame _structure 

r 

unsigned char addr_type; 
unsigned char frame Jype; 
unsigned char nr_type; 
unsigned char ns_type; 
unsigned char p jjype; 
unsigned char bccjype; 
unsigned char addrjtalue; 
unsigned char cntrl_byte; 
unsigned char nr_value; 
unsigned char ns_value; 

); 

struct send _frame_structure transmit Jrame; 
static char transmil_string [) = "(.(FOX)) 

) 

LAVER: 2 

STATE: send_a_frame 

CONDITIONS: KEYBOARD " * 

ACTIONS: 

{ 

_ge tjl_m sgjsuff( & i l_buffer_n umber, Jcrel ay_baton ) ; 

_start_ii_buff Jisl(ii buffer _number,&data_start_offset); 
transmit Jrame. bccjype = }; 

_lnserljl_buffjist_cnt(il_buffer_number, data_start_offset, &transmit_slring{0] , 
(sizeof(transmit_slring) - 1)); 

send Jrame(il_buffer_number, relay_baton, data_start_offset , ^transmit Jrame); 

) 


JUL ‘90 


74-13 



INTERVIEW 7000 Series Advanced Programming: ATLC-1 07-951 -108 


( 


74-14 


JUL '90 




75 X.25 Laver 3 Library 


75 X.25 Layer 3 Library 


When the X.25 Layer 3 package is loaded in via the Layer Setup screen, the following 
external routines and variables become available for use by the programmer. Their use on 
the Protocol Spreadsheet is not limited to any particular layer, though normally they belong at 
Layer 3. 

The variables and routines approximate X.25 Layer 3 spreadsheet-generated conditions and 
actions. Refer to Section 37 for more detailed explanations of the purposes of specific 
conditions and actions. Sometimes the name of the variable or routine is sufficient for 
identifying its related spreadsheet token. When this is not the case, the information is 
provided below. 


75.1 Structures 

The send jacketjstructure defines the format of transmitted X.25 packets. See 
Table 75-1. Use this structure to send packets via the send jacket routine in 
emulate mode. See Section 75.3(B). Each variable in the structure relates to some 
softkey selection or user entry in the SEND action. 

75.2 Variables 

(A) Monitoring Events 

1. Emulate or monitor mode. Two X.25 Layer 3 event variables are valid in 
either emulate or monitor mode. These event variables are dte jacket and 
dee jacket. 

When the user selects DTE or DCE on the first rack of softkeys for Layer 3 
conditions, a second rack appears from which he must select a particular 
packet type. A DTE DATA condition, for example, when translated, includes 
two C variables, one event variable and one status variable: 

1 

dte jacket && (m jacketjype == 0) 

} 
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Table 75-1 

X.25 Layer 3 Structures 


Type Variable Value (hex/decimal) Meaning 


Structure Name: send_packet_structure Structure of a packet In X.25, Declared as type 

struct. Declared automatically If a 
softkey-entered SEND action Is taken. Program 
packets assigned to structure as follows: struct 
send_packet_structure name. Reference a 
structure variable as follows: name. q_blt. If 
values In the frame structure are not Initialized by 
the user, they default to 0. You may Initialize the 
values when the structure Is declared: 
struct send_packet_structure name = {2, 0xt3, 
0x13. 0, 0, 0. 1, 0, 0, 0, 1, 1 , 0, 0, 2, 
&facliltles_strlnglO), 0, 0}; 


unsigned char 

path_num 

0-8 

path number 



fe/254 

use path number of last received packet 

unsigned char 

packet_type 

(The codes for packet_type are the same as for the X.25-varlable 



m _packet_type.) 


unsigned char 

packet_type_byte 

(actual value of the packet type byte) 

unsigned char 

m_blt 

0 

m = 0 



1 

m = 1 

unsigned char 

d_blt 

0 

d = 0 



40/64 

d = 1 

unsigned char 

q_blt 

0 

q = 0 



80/128 

q = 1 

unsigned char 

pr_type 

0 

auto 



1 

value 



2 

received ps plus 1 



3 

last pr sent 

unsigned char 

pstype 

0 

auto 



1 

skip 



2 

received pr 



3 

value 

unsigned char 

pr_value 

0-7 (MOD 8) 

If pr_type = 1 

unsigned char 

ps^value 

0-7 (MOD 8) 

If ps_type = 3 

unsigned char 

cause 

(value of cause byte— see Figure 36-15) 

unsigned char 

dlag_flag 

0 

diagnostic field not present 



1 

diagnostic field Is present 

unsigned char 

dlag 

(value of diagnostic byte— consult CCITT Recommendation X.25, 



pp. 237-8) 


unsigned char 

spare 

0 

reserved space 

unsigned char 

facliltleslen 

0-ffl0-255 

length of the facilities field 

char * 

facilities 


pointer to the location of the facilities field— the 
facilities field Is declared separately 

unsigned short 

datalen 


reserved for future use 

char * 

data 


reserved for future use 
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Table 75-2 

X.25 Layer 3 Variables 


Type 

Variable 

Value (hex/decimal) Meaning 

extern event 

dte_packet 


True when a DTE packet Is 
detected. Line Setup 
configured for emulate or 
monitor mode. 

extern event 

dce_packet 


True when a DCE packet Is 
detected. Line Setup 
configured for emulate or 
monitor mode. 

extern event 

rcvd_packet 


True when a packet Is received 
from Layer 2. Line Setup 
configured for emulate mode 
only. 

Bxtern event 

lnvalid_packet 


True when an Invalid paoket Is 
detected. Line Setup 
configured for emulate mode 
only. 

extern event 

pr_error 


True when an P(R) error Is 
detected In a data or 
supervisory packet. Line Setup 
configured for emulate mode 
only. 

extern event 

pe_error 


True when an P(S) error Is 
detected In a data packet. Line 
Setup configured for emulate 
mode only. 

extern event 

packet_sent 


True when a packet has been 
passed down to Layer 2. Line 
Setup configured for emulate 
mode only. 

extern volatile unsigned short 

m_packet_lcn 

0-llfl0-4095 

Logical channel number. Line 
Setup configured for emulate or 
monitor mode. 

extern volatile unsigned char 

mpacketjcngrp 

o-r io~i5 

Logical channel group number. 
Line Setup configured for 
emulate or monitor mode. 

extern volatile const unsigned char 

mpacketq 

0 

80/128 

q=0 

q=i 

Line Setup configured for 
emulate or monitor mode. 

extern volatile const unsigned char 

m_packet_d 

0 

40/64 

d=0 

d=1 

Line Setup configured for 
emulate or monitor mode, 

extern volatile const unsigned char 

m_packet_m 

0 

10/16 

m=0 

m=1 

Line Setup configured for 
emulate or monitor mode. 

extern volatile const unsigned char 

m_packet_pr 

0-7 (MOD 8) 

Line Setup configured for 
emulate or monitor mode. 

extern volatile const unsigned char 

m_packet_ps 

0-7 (MOD 8) 

Line Setup configured for 
emulate or monitor mode. 
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Table 75-2 (continued) 


Type 

Variable Value (hex/decimal) 

Meaning 


extern volatile const unsigned char 
extern volatile const unsigned char 
extern volatile const unsigned char 
extern volatile const unsigned char 


m_packet_cause 

m_packet_dlag_code 

m_packet_type_byte 

m_packet_type 


extern volatile unsigned short rcvd_pkt_lcn 

extern volatile const unsigned char rcvd_pkt_q 

extern volatile const unsigned char rcvd_pkt_d 

extern volatile const unsigned char rcvd_pkt_m 

extern volatile const unsigned char rcvd_pkt_pr 

extern volatile const unsigned char rovd _pkt_ps 

extern volatile const unsigned char rcvd_pkt_cause 

extern volatile const unsigned char rcvd_pkt_dlagn 


(same as rcvd _pkt_cause—Une Setup 
configured for emulate or monitor mode) 

(same as rcvd _pkt_dlagn—Llne Setup 
configured for emulate or monitor mode) 

(actual value of packet type byte— Line Setup 
configured for emulate or monitor mode) 

b/11 call 

f/15 call acc 

13/19 clear 

17/23 clear conf 

0 data 

23/35 Int 

27/39 Int conf 

1 rr 

5 rnr 

9 re) 

lb/27 reset 

If/31 reset conf 

fb/251 restart 

ff/255 restart conf 

f 1/241 dlag 

f3/243 reg 

f7/247 reg conf 

11/17 other pkt 

11/17 unknown pkt 

Line Setup configured for 
emulate or monitor mode. 

0-flfl0-4095 Logical channel number In a 
received packet. Line Setup 
configured for emulate mode 
only. 

0 q=0 

80/128 q=1 

Line Setup configured for 
emulate mode only. 

0 d=0 

40/64 d=l 

Line Setup configured for 
emulate mode only. 

0 m=0 

10/16 m=1 

Line Setup configured for 
emulate mode only. 

0-7 (MOD 8) Line Setup configured for 
emulate mode only. 

0-7 (MOD 8) Line Setup configured for 
emulate mode only. 

(see Figure 36-15— Line Setup configured tor 
emulate mode only) 

(consult CCITT Recommendation X.25, 
pp. 237-8— Line Setup configured for emulate 
mode only) 


( 
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Table 75-2 (continued) 


Type 


Variable Value (hex/decimal) Meaning 


extern volatile const unsigned char rcvdpkttypebyte 

extern volatile const unsigned char rcvd_packet_type 


extern volatile unsigned short m_packet_buff_seg 


extern volatile unsigned short m_packet_lnfo_seg 

extern volatile unsigned short m_packet_sdu_offset 


extern volatile unsigned short m_packet_lnfo_offset 


extern volatile unsigned short m_packet_length 

extern volatile unsigned short m_packet_lnfo_length 


(actual value of packet type byte—Llne Setup 
configured for emulate mode only) 

b/11 call 

f/15 Call aco 

13/19 clear 

17/23 clear conf 

0 data 

23/35 Int 

27/39 Int conf 

1 rr 

6 rnr 

9 re) 

lb/27 reeet 

If/31 reset conf 

fb/251 restart 

ff/255 restart conf 

fl/241 dlag 

f3/243 reg 

f7/247 reg conf 

11/17 other pkt 

11/17 unknown pkt 

Line Setup configured for 
emulate mode only. 

Inter-layer message buffer 
number (actually, an IAPX-286 
segment number). This 
segment number can be 
converted to a pointer by 
shifting It left 16 bits. Line 
Setup configured for emulate or 
monitor mode. 

Same as m _packet_bu(f_seg . 

Offset to where the service data 
unit begins In an Inter-layer 
message buffer. Add to 
m _pkt_buff_seg (converted to 
pointer) to point to first 
packet-header byte. Line Setup 
configured for emulate or 
monitor mode. 

Offset to where the packet 
Information begins, excluding 
the header. Add to 
m _pkt_buff_seg (converted to 
pointer) to point to packet data. 
Line Setup configured for 
emulate or monitor mode. 

Length of the packet. Including 
header. Line Setup configured 
for emulate or monitor mode. 

Length of the packet 
Information, excluding the 
header. Line Setup configured 
for emulate or monitor mode. 
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Table 75-2 (continued) 


Type 


Variable Value (hex/decimal) Meaning 


extern volatile unsigned short rcvd_pkt_buff_seg 


extern volatile unsigned short rcvd _pkt_lnfo_seg 

extern unsigned short rcvd_pkt_sdu_offset 


extern volatile unsigned short rcvd j5kt_lnfo_offset 


extern unsigned short rcvd_pkt_length 

extern volatile unsigned short rcvd_pkt_lnfo_length 

extern volatile unsigned char * m_packet_ptr 

extern volatile unsigned char * mj>acket_lnfo_ptr 


extern volatile unsigned char * rcvd _packet_ptr 

extern volatile unsigned char * rcvd_pkt_lnfo_ptr 


Inter-layer message buffer 
number (aotually, an IAPX-266 
segment number) In a received 
packet. This segment number 
can be converted to a pointer 
by shifting It left 16 bits. Line 
Setup configured for emulate 
mode only, 

Same as rcvd _pkt_buff_seg . 

Offset to where the service data 
unit begins In an Inter-layer 
message buffer In a packet 
received. Add to 
rcvd _pkt_buU_seg (converted to 
pointer) to point to first 
packet-header byte. Line Setup 
configured for emulate mode 
only. 

Offset to where the packet 
Information begins, excluding 
the header. Add to 
rcvd _pkt_buff_seg (converted to 
pointer) To point to packet data. 
Line Setup configured for 
emulate mode only. 

Length of a received packet, 
Including header Information. 
Line Setup configured for 
emulate mode only. 

Length of the Information In a 
received packet, excluding the 
header. Line Setup configured 
for emulate mode only. 

Pointer to the packet, beginning 
at the flret byte In the header, 
Line Setup configured for 
emulate or monitor mode. 

Pointer to the Information In a 
packet. Initially points to the 
byte Immediately following the 
packet-type byte. Line Setup 
configured for emulate or 
monitor mode. 

Pointer to the packet, beginning 
at the first byte In the header. 
Line Setup configured for 
emulate mode only. 

Pointer to the packet 
Information, Initially located at 
the byte Immediately following 
the packet header. Line Setup 
configured for emulate mode 
only. 


75-6 


JUL '90 






75 X.25 Laver 3 Library 


Table 75-2 (continued) 


Type 

Variable 

Value (hex/decimal) Meaning 

extern volatile const unsigned char 

rcvd_device_path 


Path number connecting 
received packet to particular 
LCN and particular set of call 
parameters on the X.25 Packet 
Level Setup screen. Line Setup 
configured for emulate mode 
only. 

extern unsigned char 

13 enhance 

0 

normal 



1 

reverse 



4 

low 



5 

reverse low 



8 

blink 



9 

reverse blink 



12/18 

blink low 




Line Setup configured for 
emulate or monitor mode. 

extern unsigned char 

I3_suppress 

0 

off 



1 

on 




Line Setup configured for 
emulate or monitor mode. 


A C programmer does not have to specify a packet type. To include all 
packets in a condition, use the event variable only: 

CONDITIONS: 

{ 

die _packet 

} 

2. Emulate mode only. Some events may be detected in emulate mode only. 
These are rcvd _packet, invalid _packet, pr_error, psjerror, and packet __sent . 

If you try to use one of these variables in monitor mode, you may be 
returned to the main program menu. When you go to the Protocol 
Spreadsheet and search for errors, a message like the following may be 
displayed; "Error 140: Unresolved reference rcvd_packet." 

When the user selects RCV on the first rack of softkeys for Layer 3 
conditions, a second rack appears from which he must select a particular 
packet type. When the translator converts a RCV DATA condition into C, it 
will include two C variables, one event variable and one status variable: 

{ 

rcvd jacket && (rcvd jacketjype == 0) 

) 

As a C programmer, you do not have to specify a packet type. To include 
all received packets in a condition, use the event variable only: 

CONDITIONS: 

< 

rcvd jacket 

} 
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Error detecting may be accomplished via pr_error, ps_error, and 

invalid _packet. These variables equate to the softkey tokens bearing similar 

names. 

One of the emulate-mode variables monitors an emulate action. “SEND”ing 
a packet means queuing a packet to be passed down to Layer 2. If the 
Layer 2 link is not established, for example, the packet will be held at Layer 
3 pending link establishment. The event variable packet jent will not come 
true until the packet actually has been passed to the layer below. Use this 
condition to start accurate response-time measurements at the packet level 
rather than at the line level. 

(B) Status Variables 

Status variables are those in Table 75-2 that do not include event in the Type 
column. Their associated event variables guarantee that they are updated and 
tested. 

The softkey-generated condition for received Data packets is RCV DATA. The C 
version of the same condition should look like this: 

CONDITIONS: 

< 

rcvd _packet AA ( rcvd _packel_type -= 0) 

> ' ( 

1. Packet characteristics. All status variables in Table 75-2 containing an m_ 
prefix are valid in either emulate or monitor mode: m _packet_lcn, 

m jacket Jcnjrp, m _packet_q, m jacket_d, m jacket _m, m jacket jr, 
m jacket js, m jacket_cause, m jacket _diag_code, m jacket _type, and 
m jacket jype_byte. 

All status variables in Table 75-2 containing a rcvd_ prefix are valid in 
emulate mode only: rcvd jktjcn, rcvd jkt_q , rcvd jktji, rcvd jktji, 
rcvd jkt jr, rcvd jkt js, rcvd jktjause, rcvd jkt_diagn, rcvd jktjype, 
and rcvd jkt_type_byte. 

If you try to use an emulate-mode variable in monitor mode, you may be 
returned to the main program menu. When you go to the Protocol 
Spreadsheet and search for errors, a message like the following may be 
displayed: “ Error 140: Unresolved reference rcvd jacket Jype." 

2. Packet buffers. Packets are passed up to Layer 3 from Layer 2 in IL 
message buffers. Several variables provide the user with access to the 
information in the packet that is located beyond the packet-type byte. 

These variables are rcvd jkt_buff_seg, m jacket _buffjseg, 

rcvd jkt_sdujffset, m jacket _sdujff set , rcvd jkt_length, and 
m jacket Jength. See Section 66.1 for a more detailed discussion of the 
buffer components to which these variables refer. 

3. Pointers. Two variables, rcvd jktjnfo jtr and m jacket Jnfo jtr, point to 

the first byte beyond the packet header. You may move these pointers to ( 
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access data throughout the length of the packet, The length is indicated by 
rcvd _pkt_info_length (or m _packet_infoJength) . 

4. Path. An IL buffer that is sent down the layers or received up the layers is 
provided with a ‘‘path" number that ties it, at X.25 Layer 3, to a particular 
LCN as well as to a particular set of Call Request parameters on the X.25 
Packet Level Setup screen. 

When a call request is sent or received by the INTERVIEW, the call 
parameters are correlated to the Packet Level Setup screen. If the 
INTERVIEW sends. a call request that specifies a path number, or if the 
INTERVIEW receives a call request that matches one of the path entries on 
the setup screen, the LCN of the call request is tied to the path number 
(path #3, for example), and any subsequent packets with the same LCN will 
satisfy rcvd_device jath == 3 conditions. 

(C) Controlling Protocol Trace Display 

To enhance or suppress particular packets on the Layer 3 Protocol Trace screen 
in emulate or monitor mode, assign a coded value to I3_enhance or I3_suppress. 
The values are listed in Table 75-2. To assign a value to either of these 
variables, place the statement in an actions block. For example, display RNR 
packets in reverse-video and suppress display of invalid packets: 

CONDITIONS: RCV RNR 
ACTIONS: 

< 

13 enhance = 1; 

) 

CONDITIONS: RCV INVALID 
ACTIONS: 

{ 

13_suppress = 1; 

) 

Check the value of these display-control variables in a CONDITIONS block 

CONDITIONS: RCV DATA 

< 

13 _enhance == I 

) 

ACTIONS: 

{ 

I3_enhance = 0; 

) 

or an ACTIONS block: 

CONDITIONS: RCV DATA 
ACTIONS: 

{ 

if(l3_enhance == 1) 

I3_enhance = 0; 

) 
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75.3 Routines 

Use the following routines in emulate mode only. If you try to call one of these 
routines in monitor mode, you may be returned to the main program menu. When 
you go to the Protocol Spreadsheet and search for errors, a message like the 
following may be displayed; " Error 140: Unresolved reference !3_give_data." 

(A) Receive 
I3_glve_data 

Synopsis 

extern void I3_give_data( ); 

Description 

The I3_give_data routine takes an interlayer message buffer associated with a 
received data packet, changes the SDU offset to point to higher-level data, and 
sends an N_DATA IND primitive up to Layer 4 along with a reference to this 
buffer. The softkey equivalent of this routine is the GV_DATA action on the 
Protocol Spreadsheet. 

Example 

Layer 4 wants access to the line in order to receive and send data. Assuming 
X.25 personality packages are loaded at Layers 2 and 3, enter the following 
program; 

LAYER: 2 

STATE; datallnk 

CONDITIONS: DLCONNECT REQ 
ACTIONS; DL CONNECT CONF 
CONDITIONS: DL_DAT A REQ 
ACTIONS: SEND INFO “((DL DATA)) ” 

CONDITIONS: RCV INFO 
ACTIONS: QIVE_DATA 
LAYER: 3 

STATE: pass_data_up 

CONDITIONS: N_CONNECT REQ 
ACTIONS: SEND CALL 
CONDITIONS: RCV CALL_CONF 
ACTIONS: N_CONNECT IND 
CONDITIONS: N_DATA REQ 
ACTIONS: SEND DATA “(CN_DATA)) ’ 

CONDITIONS: RCV DATA 
ACTIONS: 

1 

I3_give_data(); 

} 

LAYER: 4 

STATE: establlshjlnk 

CONDITIONS: ENTER_STATE 
ACTIONS: N CONNECT REQ 
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(B) Transmit 
I3_clear_path 

Synopsis 

extern void I3_clear _path (path number); 
unsigned char path_number; 

Description 

The I3_clear _path routine resets P(R)- and P(S) -related variables, clears the 
transmit window, and resets the LCN and address fields to void (unless 
permanently assigned on the Layer 3 X.25 Packet Level Setup screen) on a 
designated path. 

Inputs 

The only parameter is the path number which is to be cleared. The value may 
be 0 - 8, or Oxfe if you want the path number to be that of the last received 
packet. 

Example 

When a Clear packet is received, clear the path. 

LAYER: 3 

STATE: clearing 

CONDITIONS: RCV CLEAR 
ACTIONS: SEND CLEAR_CONF 
{ 

I3_clear _path(0xfe); 

) 


!3_more_to_resend 

Synopsis 

extern unsigned char l3_more_to_resend(path_number); 
unsigned char path_number; 

Description 

The l3_more_to_resend routine determines whether or not there are any more 
packets in the transmit window to resend. It is used in combination with a 
transitional condition such as packe(_sent as a condition on the Protocol 
Spreadsheet. The softkey equivalent is PACKET_SENT MORE_TO_RESEND or 
PACKET SENT NO_MORE_TO_RESEND. 
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Inputs 

The only parameter is the path number associated with the transmit window. 

The value may be 0 - 8, or Oxfe if you want the path number to be that of the 
last received packet. 

Returns 

If there is more to resend, the returned value is non-zero. If there is no more 
to resend, or if the given path is invalid, the returned value is 0. 

Ekampig 

In this example, the entire transmit window will be resent. 

{ 

extern event packet_sent; 

} 

LAYER: 3 

STATE: xfer 

/* Whatever conditions and actions send data precede the following condition. */ 

CONDITIONS: RCV REJ 
ACTIONS: RESEND FIRST 
NEXT_STATE: recover 
STATE: recover 

CONDITIONS: ENTER_STATE 

1 

packet_sent &&(l3_more_to_resend(Oxfe ) 1= 0) 

) 

ACTIONS: RESEND_NEXT 
CONDITIONS: 

{ 

packet sent <Si&(l3_more_lo_resend(0xfe) == 0) 

) 

NEXT_STATE: xfer 

!3_window_full 

S yno psis 

extern unsigned char l3_window _full(path_number); 
unsigned char pathjiumber; 

Descr iption 

This routine determines whether the Layer 3 window for a specified path is full 
or not full. When the window is full, no additional packets will be buffered until 
some acknowledgment is received. It is used in combination with a transitional 
condition such as receive ^ packet as a condition on the Protocol Spreadsheet. 

The softkey equivalent is RCV RR (PROTOCL) WINDOW NOT_FULL or RCV RR 
(PROTOCL) WINDOW FULL. 
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In put s 

The only parameter is the path number whose window is to be checked. The 
value may be 0 - 8, or Oxfe if you want the path number to be that of the last 
received packet. 

Returns 

If the window is full, or if the given path is invalid, the returned value is 
non-zero. If the window is not full, the returned value is 0. 

Example 

Transmit data packets until the transmit window is full. 

1 

extern event packet sent; 

} 

LAYER: 3 

STATE: check_wlndow 
CONDITIONS: 

< 

packetjsent && (13 window _fuli(0xfe) 1= 0) 

} 

ACTIONS: SEND DATA “((FOX))” 

l3_window_empty 

Synopsis 

extern unsigned char l3_window_empty(path_number ); 
unsigned char path_number; 

Description 

This routine determines whether the Layer 3 window for a specified path is 
empty or not empty. It is used in combination with a transitional condition such 
as receive _packet as a condition on the Protocol Spreadsheet. The softkey 
equivalent is RCV RR (PROTOCL) WINDOW NOT_EMPTY or RCV RR (PROTOCL) 
WINDOW EMPTY. 

In pu t s 

The only parameter is the path number whose window is to be checked. The 
value may be 0 - 8, or Oxfe if you want the path number to be that of the last 
received packet. 

Returns 

If the window is empty, or if the given path is invalid, the returned value is 
non-zero. If the window is not empty, the returned value is 0. 
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Example 

If a timeout expires and the transmit window is not empty, resend the first 
packet in the window. 

< 

extern event timeout jckjxpired; 
extern event rcvd jacket; 

) 

LAYER: 3 

STATE: check_wlndow 

CONDITIONS: PACKET_SENT 
ACTIONS; TIMEOUT ack RESTART 
CONDITIONS: 

{ 

rcvd jacket 

) 

ACTIONS: TIMEOUT ack STOP 
CONDITIONS: 

< 

timeout jck expired && (13 window jmpty(Oxfe) I- 0) 

) 

ACTIONS: RESEND FIRST 

resend_packet ^ 

Syn o ps is 

extern void resend jacket (path jumber, first jrjext); 
unsigned char path jumber; 
unsigned char first jrjext; 

Description 

The resend jracket routine will resend either the first or next packet in the 
window along a specified path. The softkey equivalent of this routine is the 
RESEND action on the Protocol Spreadsheet. 

Inputs 

The first parameter is the value of the path on which to resend the packet. It 
may be 0 - 8, or Oxfe for the path of the last received packet. 

The second parameter indicates whether the first packet in the window will be 
sent, or whether the next packet in the window will be sent. The first resend 
action will send the first packet in the window regardless of whether first or next 
has been selected. Legal entries are 0 (first) or 1 (next). 

Example 

Suppose you want to resend the entire transmit window if you receive a REJ 

packet. In this example, it’s being sent along the path of the last received 

packet. 1 
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LAYER: 3 

STATE: xfer 

/* Whatever conditions and actions send data precede the following condition. */ 

CONDITIONS: RCV REJ 
NEXT_STATE: recover 
STATE: recover 

CONDITIONS: ENTER_STATE 
ACTIONS: 

< 

resend jacket (Oxfe , 0 ); 

) 

CONDITIONS: PACKET_SENT 
MORE_TO_RESEND 
ACTIONS: 

{ 

resend jacket (Oxfe, l); 

) 

CONDITIONS: PACKET_SENT 
NO_MORE TO_RESEND 
NEXT STATE: xfer 


reset_pr_ps 

Synopsis 

extern void reset jr js(pathjumber) ; 
unsigned char pathjumber; 

Description 

The P(R) and P(S) fields in data and supervisory packets are reset to zero. The 
transmit window is also cleared. The softkey equivalent of this routine is the 
(PROTOCL) RSTPRPS action on the Protocol Spreadsheet. 

Inputs 

The only parameter is the path number on which P(R) and P(S) are to be reset. 
The value may be 0 - 8, or Oxfe if you want the path number to be that of the 
last received packet. 

Example 

In this example, P(R) and P(S) are reset on path 2 whenever a Reset packet is 
received. 

LAYER: 3 

STATE: reset 

CONDITIONS: RCV RESET 
ACTIONS: 

{ 

reset jr js( 2); 

} 
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send_packet 

Synopsis 

extern void send jacket(il_buffer_number, relay J>aton, data_start_offset, 
transmit jacket jtr); 
unsigned short ll_buffer_number; 
unsigned short relay Jraton; 
unsigned short data_slart offset; 

struct send jacketjtructure 

{ 

unsigned char pathjum; 
unsigned char packet_iype; 
unsigned char packet JypeJbyte; 
unsigned char m bit; 
unsigned char djbit; 
unsigned char q_bit; 
unsigned char pr_type; 
unsigned char psjype; 
unsigned char prjalue; 
unsigned char ps_value ; 
unsigned char cause; 
unsigned char diagjiag 
unsigned char diag; 
unsigned char cntrl_byte; 
unsigned char facilities Jen; 
char * facilities; 
unsigned short data Jen; 
char * data; 

); 

struct send jacket _structure * transmit jacket jtr; 


D es cri ptio n 

The send _packet routine adds a packet-level header to an interlayer message 
buffer and passes the buffer to Layer 2. The softkey equivalent of this routine is 
the SEND action on the Protocol Spreadsheet. 

logins 

The first parameter is the interlayer message buffer number. See Section 
66.3(A), Layer-Independent OSI routines. 

The second parameter is the maintain bit used to hold the buffer while the send 
operation is being performed. See See Section 66.3(A). 

The third parameter is the offset from the beginning of the buffer to the start of 
the service data unit. See See Section 66.3(A). 

The fourth parameter is a pointer to the packet structure to be sent. For a 
description of send jpacket structure see Table 75-1. 
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Example 

To successfully send a packet out to the line, you must include the Layer 2 
section of the program below. In this example, you are sending a Call Request 
packet with a facilities field present. 

{ 

static unsigned short itjrufferjumber; 
static unsigned short relay_baton; 
static unsigned short datajlartjffset; 

struct send jacket structure 

{ 

unsigned char pathjum; 
unsigned char packet_type; 
unsigned char packet _lype_byte; 
unsigned char m_blt; 
unsigned char d_bil; 
unsigned char q_bit; 
unsigned char prjype; 
unsigned char psjtype; 
unsigned char prjalue; 
unsigned char ps_value; 
unsigned char cause; 
unsigned char diagjiag 
unsigned char dlag; 
unsigned char cntrl_byte; 
unsigned char facilities_len; 
char * facilities; 
unsigned short data Jen; 
char * data; 

); 

static char transmit_string (] = "(.(.FOX)) "; 

static char facilities_string // = "VAViViS 0 / 0 !"; 

struct send jacket ^structure transmit jacket = { 0 . 0x13, 0x13, 0, 0, 0, 0, 0, 0, 0, 1 , 1 , 0, 0, 
(sizeof(facilities_string)-l), &facillties string[0 ], 0, 0); 

)' 

LAVER: 2 

STATE: datallnk 

CONDITIONS: DL_CONNECT REQ 
ACTIONS: DL_CONNECT CONF 
CONDITIONS: DL DATA REQ 
ACTIONS: SEND INFO “((DL_DATA» ” 

CONDITIONS: RCV INFO 
ACTIONS: GIVE_DATA 
LAYER: 3 

STATE: send a packet 

CONDITIONS: KEYBOARD “ ” 

ACTIONS: 

< 

_get ii_msgJ>uff(&HJ>ufferjumber, <&relay_baton); 
_startji_buffjist(ilj3uffer_number,&data_siartjffset); 

JnsertJI_buffJistjnt(il_bufferjumber, dala_slarljf}set, <Sitransmit_strlnglO] , 
(sizeof ( transmit_string) - 1)); 

send jacket (iljbufferjumber, relay _baton, data_startjffset, ^transmit jacket) ; 

l 
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NOTE: A null is appended to the end of an array initialized as a 
string inside quotation marks; it is not appended to the end of an 
array entered inside curly braces. So, if facilities _string was 
initialized as a list of values, like this— 

static char facililies_strlng [J = {1, I, 4, l, 0x41, 0x45, 0x03, 0x43, 7, 7); 

—then transmit _packet would look like this— 

struct send _packet _structure transmit _packet = { 0 , 0x13, 0x13, 0, 0, 0, 0, 0, 0, 0, I, 
1, 0, 0, sizeof(facllities_string), <Scfacltlties_stringlO), 0, 0); 
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When the SDLC package is loaded in via the Layer Setup screen, the following external 
routines and variables become available for use by the programmer. Their use on the 
Protocol Spreadsheet is not limited to any particular layer, though normally they belong at 
Layer 2. 

The variables and routines approximate SDLC Layer 2 spreadsheet-generated conditions and 
actions. Refer to Section 38 for more detailed explanations of the purposes of specific 
conditions and actions. Sometimes the name of the variable or routine is sufficient for 
identifying its related spreadsheet token. When this is not the case, the information is 
provided below. 

76.1 Structures 

The structure send _frame_struclure defines the format of transmitted SDLC frames. 
See Table 76-1. Use this structure to send frames via the sendjrame routine in 
emulate mode. See Section 76.3(B). Each variable in the structure relates to some 
softkey selection or user entry in the SEND action. 

76.2 Variables 

(A) Monitoring Events 

1. Emulate or monitor mode. SDLC events include frames detected, good or 
bad BCC’s, and aborts. All event variables in Table 76-2 containing a dte_ 
or dce_ prefix are valid in either emulate or monitor mode. These event 
variables are dte Jrame, dee Jrame, dte_good_bcc, dce_good_bcc, 
dte_bad_bcc, dce_bad_bcc, dtejabort, dce_abort. The variable 
dce_good_bcc, for example, equates to DCE GDBCC. 

You can use both dte and dee variables relating to the same event in one 
conditions block. Suppose you want to count all bad BCC’s from either side 
of the line. Enter the following CONDITIONS/ACTIONS block: 

CONDITIONS: 

{ 

dte_bad_bcc 1 1 dce_bad_bcc 

) 

ACTIONS: COUNTER bad bcc INC 
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Table 76-1 
SDLC Structures 


Type 

Variable 

Value (hex/declmal) Meaning 

Structure Name: send frame 

structure 

Structure of a frame In SDLC. Declared as type 




struct. Declared automatically If a 
softkey-entered SEND action is taken. Program 
frames assigned to structure as follows: struct 
send_frame_structure name. Reference a 
structure variable as follows: name. bcc_type. If 
values In the frame structure are not Initialized by 
the user, they default to 0. You may initialize the 
values when the structure Is declared: 




struct send_frame_structure name - {2, 1, 1,0, 
1, 1.3, 0x71, 3, 0); 

unsigned char 

addr type 

2 

address Is specified In addr value variable below 



3 

loopback 

unsigned char 

frame_type 

(The codes for framejype are the same as for the SDLC-varlable 
rcvdjramejype . ) 

unsigned char 

nr type 

0 

auto 



1 

value 



2 

received ns plus 1 



3 

last nr sent 

unsigned char 

ns type 

0 

auto 



1 

skip 



2 

last nr received 



3 

value 

unsigned char 

pjjvpe 

0 

1 

2 

0 

1 

loopback 

unsigned char 

bcc type 

0 

default (bad bcc) 



t 

good bco 



2 

bad bcc 



3 

abort 

unsigned char 

addr_value 

OO-fffO-255 


unsigned char 

cntrl_byte 

(actual value of the control byte) 

unsigned char 

nr_value 

0-7 (MOD 8) 

if nr_type = 1 

unsigned char 

nsvalue 

0-7 (MOD 8) 

if ns type = 3 


( 
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Table 76-2 
SDLC Variables 


Type 

Variable Value (hex/decimal) 

Meaning 


extern event 
extern event 
extern event 
extern event 
extern event 
extern event 

( 

extern event 

extern event 

extern event 
extern event 

extern event 

extern event 

extern event 


dte_frame 

dce_(rame 

dte_good_bcc 

dce_good_bcc 

dte_bad_bcc 

dce_bad_bec 

dte_abort 

dce_abort 

rcvd_frame 

lnvalld_frame 

I2_T1 

bccerror 

nr error 


extern event 


ns error 


True when a DTE frame Is 
detected. Line Setup 
configured for emulate or 
monitor mode. 

True when a DCE frame Is 
detected. Line Setup 
configured for emulate or 
monitor mode. 

True when a good BCC Is 
calculated for a DTE frame. 

Line Setup configured for 
emulate or monitor mode. 

True when a good BCC Is 
calculated for a DCE frame. 

Line Setup configured for 
emulate or monitor mode. 

True when a bad BCC Is 
calculated for a DTE frame. 

Line Setup configured for 
emulate or monitor mode. 

True when a bad BCC Is 
calculated for a DCE frame. 

Line Setup configured for 
emulate or monitor mode. 

True when an abort Is detected 
for a DTE frame. Line Setup 
configured for emulate or 
monitor mode. 

True when an abort Is detected 
for a DCE frame. Line Setup 
configured for emulate or 
monitor mode. 

True when a frame Is received, 
Line Setup configured for 
emulate mode only. 

True when an Invalid frame Is 
detected. Line Setup 
configured for emulate mode 
only. 

True when the T1 tlmeout-tlmer 
has expired. Line Setup 
configured for emulate mode 
only. 

True when a BCC error Is 
detected. Line Setup 
configured for emulate mode 
only. 

True when an N(R) error Is 
detected In a received INFO or 
supervisory frame. Line Setup 
configured for emulate mode 
only. 

True when an N(S) error Is 
detected In a received INFO 
frame. Line Setup configured 
for emulate mode only. 
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Table 76-2 (continued) 


Type 


Variable Value (hex/decimal) Meaning 


extern event 

extern volatile const unsigned char 
extern volatile const unsigned char 
extern volatile const unsigned char 
extern volatile const unsigned char 

extern volatile const unsigned char 


extern volatile const unsigned char 
extern volatile const unsigned char 


extern volatile const unsigned char 
extern volatile const unsigned char 


frame_sent True when frame Is passed 

down to Layer 1 . Line Setup 
configured for emulate mode, 
only, 

m_frame_addr OO-fffO-255 Line Setup configured for 

emulate or monitor mode. 

m_frame_type (same as rcvdjrame_type—Une Setup 

configured tor emulate or monitor mode) 


m_frame_cntrl_byte_1 (actual value of control byte— Line Setup 

configured lor emulate or monitor mode) 


m_frame_pf 

0 

pf=0 


10/16 

pf=1 



Line Setup configured for 
emulate or monitor mode 

m_frame_bcc_type 

1 

good 


2 

bad 


3 

abort 



Line Setup configured for 
emulate or monitor mode 

rcvd_frame_addr 

OO-ftlO-2 55 

Line Setup configured for 
emulate mode only. 

rcvd_frame_type 

0 

Info 


1 

rr 


5 

rnr 


9 

re) 


d/13 

sre| 


3 

ul 


7 

rim 


7 

slm 


f/15 

dm 


23/35 

up 


43/67 

disc 


43/67 

rd 


63/99 

ua 


83/131 

snrm 


87/135 

frmr 


af/175 

xld 


C7/199 

cfgr 


cf/207 

snrme 


e3/227 

test 


ef/239 

ben 


b/1 1 

Ipda 


ff/240 

other 


ff/240 

unknown 



Line Setup configured for 
emulate mode only, 

rcvd_frame_cntrl_byte_1 

(actual value of control byte— Line Setup 
configured for emulate mode only) 

rcvd_frame_pf 

0 

pf=0 


10/16 

pf=1 



Line Setup configured for 
emulate mode only. 
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Table 76-2 (continued) 


Type 


Variable Value (hex/decimal) Meaning 


extern volatile const unsigned char 


extern volatile const unsigned char 
extern volatile const unsigned char 
extern volatile unsigned short 


extern volatile unsigned short 


extern volatile unsigned short 


extern volatile unsigned short 


extern volatile unsigned short 
extern volatile unsigned short 
extern volatile unsigned short 


rcvdframebcctype 


rcvd frame nr 


rcvd frame ns 


1 good 

2 bad 

3 abort 

Line Setup configured for 

emulate mode only. 

0-7 (MOD 8) Line Setup configured for 

emulate mode only. 

0-7 (MOD 8) Line Setup configured for 

emulate mode only. 


rcvd_frame_buff_seg 


rcvd_frame_sdu_offset 


rcvd frame sdu size 


l2_current_wlndow_edge 


l2_lower_wlndow_edge 

l2_upper_window_edge 

I2_resend_edge 


Inter-layer message buffer 
number (actually, an IAPX-286 
segment number) In a received 
frame. This segment number 
can be converted to a pointer 
by shifting it left 16 bits. Line 
Setup configured for emulate 
mode only. 

Offset to where the service data 
unit begins In an Inter-layer 
message buffer In a received 
frame. Add to buffer segment 
number (converted to pointer) 
to point to first byte In frame. 
Line Setup configured for 
emulate mode only. 

Size of service data unit In a 
received frame. Line Setup 
configured for emulate mode 
only. 

When equal to upper edge, 
window Is full; when equal to 
lower edge, window Is empty; 
when not equal to upper edge, 
window Is not full; and when not 
equal to lower edge, window Is 
not empty. Line Setup 
configured for emulate mode 
only. Valid for point-to-point 
operation only. 

see l2_current_wlndow_edge 

see l2_current_window_edge 

When resend edge Is not equal 
to lower window edge, there Is 
more to resend; when resend 
edge Is equal to lower window 
edge, there Is no more to 
resend. Line Setup configured 
for emulate mode only. 
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Table 76-2 (continued) 


Type 

Variable 

Value (hex/decimal) Meaning 

extern unsigned char 

12 enhance 

0 

normal 



1 

reverse 



4 

low 



5 

reverse low 



8 

blink 



. 9 

reverse blink 



12/18 

blink low 




Line Setup configured for 
emulate or monitor mode. 

extern unsigned char 

12 suppress 

0 

off 



1 

on 




Line Setup configured for 
emulate or monitor mode. 


Using spreadsheet tokens, the same test needs two CONDITIONS/ACTIONS 
blocks: 

CONDITIONS: DTE BDBCC 
ACTIONS: COUNTER bad_bcc INC 
CONDITIONS; DCE BDBCC 
ACTIONS: COUNTER bad_bcc INC 

When the user selects DTE or DCE on the first rack of softkeys for Layer 2 
conditions, a second rack appears from which he must select a particular 
frame type. A DTE INFO condition, for example, when translated, includes 
two C variables, one event variable and one status variable: 

{ 

dte_frame && (m Jramejype == 0) 

} 

As a C programmer, you do not have to specify a frame type. To include 
all frames in a condition, use the event variable only: 

CONDITIONS: 

' { 

die _Jrame 

) 

2. Emulate mode only. Some events may be detected in emulate mode only. 
The event variables are rcvd _frame, invalid _Jrame, 12 TI, bcc_error, 
nr_error, nsjerror, and frame _sent. 

If you try to use one of these variables in monitor mode, you may be 
returned to the main program menu. When you go to the Protocol 
Spreadsheet and search for errors, a message like the following may be 
displayed: "Error 140: Unresolved reference rcvd Jrame." 

When the user selects RCV on the first rack of softkeys for Layer 2 
conditions, a second rack appears from which he must select a particular 
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frame type. When the translator converts a RCV INFO condition into C, it 
will include two C variables, one event variable and one status variable: 

{ 

rcvd Jrame && (rcvd Jrame Jype == 0) 

) 

In a C condition, a frame type does not have to be specified. To include all 
received frames in a condition, use the event variable only: 

CONDITIONS: 

1 

rcvd _Jrame 

} 

Error detecting may be accomplished via bccjerror, nr_error, ns_error, and 
invalid Jrame. These variables equate to the softkey tokens bearing similar 
names. 

One of the emulate-mode variables monitors an emulate action. The event 
variable framejsent will come true as soon as the frame has been passed to 
the layer below. 

(B) Status Variables 

Status variables are those in Table 76-2 that do not include event in the Type 
column. Their associated event variables guarantee that they are updated and 
tested. 

The softkey-generated condition for received Info frames is RCV INFO. The C 
version of the same condition should look like this: 

CONDITIONS: 

{ 

rcvd Jrame && ( rcvd Jrame Jype == 0) 

} 

1. Frame characteristics. All status variables in Table 76-2 containing an m_ 
prefix are valid in either emulate or monitor mode: m Jrame jaddr, 
m Jrame Jype, m Jrame _cntrl Jyte J , m Jrame j>f, and m Jrame Jccjype. 
Use these variables to monitor a particular address, frame type, control byte, 
P/F value, or BCC. 

All status variables in Table 76-2 containing a rcvd_ prefix are valid in 
emulate mode only: rcvd Jrame_addr, rcvd Jrame Jype, 
rcvd Jrame jcntrl_byteJ , rcvd Jrame Jccjype, rcvd Jrame j>f, 
rcvdjrame_nr, and rcvd Jrame _ns. Use these variables to monitor a 
particular address, frame type, control byte, BCC, or P/F, N(R), or N(S) 
value. 
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If you try to use an emulate-mode variable in monitor mode, you may be 
returned to the main program menu. When you go to the Protocol 
Spreadsheet and search for errors, a message like the following may be 
displayed: “Error 140: Unresolved reference rcvd Jrame _type ." 

2, Frame buffers. As BOP frames are received, they are automatically placed 
in IL message buffers to be passed up the layers. Three emulate-mode 
variables provide the user with access to the information in the frame that is 
located beyond the control byte. These variables are rcvd Jrame _buff_seg, 
rcvd Jrame _sdu_off set, and rcvd Jrame _sdu_size. See Section 66.1 for a 
more detailed discussion of the buffer components to which these variables 
refer. 

Make a pointer to an IL buffer by casting rcvd Jrame _buff_seg as a long, 
shifting it left sixteen bits, adding rcvdJrame_sdu_offset, and casting the 
result to a pointer. Increment the pointer twice (thereby adding two to the 
offset). 


{ 

unsigned char * plr; 

plr - (void ‘)(((long)rcvd Jrame _bu/f_seg « 16) + rcvd Jrame_sdu_offsel) ; 
ptr*=2; 

} 

It is now pointing at the first byte in the information field. You may 
continue to move through the frame for its entire length, indicated in 
rcvd Jrame _sdu_size. 

3. Transmit window. Four related variables test the status of the Layer 2 

window in point-to-point operation. The particular values of these variables 
at any given time is not significant. What is significant is how they compare 
to each other. The softkey status condition on the left makes the variable 
comparison on the right: 

WINDOW FULL 
WINDOW EMPTY 
WINDOW NOT_FULL 
WINDOW NOT_EMPTY 
MORE_TO_RESEND 
NO„MORE_TO_RESEND 


l2jcurrent_window_edge -= l2_upper_window_edge 
l2_current_window_edge == !2Jower_wlndow_edge 
l2_current_window_edge 1= l2_upper_window_edge 
12_current_window_edge I- l2Jower_window_edge 
I2_resendjedge /= I2jower_wtndow_edge 
I2_resend_edge == I2jower_wtndow_edge 
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(C) Controlling Protocol Trace Display 

To enhance or suppress particular frames on the Layer 2 Protocol Trace screen 
in emulate or monitor mode, assign a coded value to I2jenhance or I2_suppress. 
The values are listed in Table 76-2. To assign a value to either of these 
variables, place the statement in an ACTIONS block. For example, display RNR 
frames in reverse-video and suppress display of invalid frames: 

CONDITIONS: RCV RNR 
ACTIONS: 

{ 

I2_enhance = 1; 

) ■ 

CONDITIONS: RCV INVALID 
ACTIONS: 

{ 

I2_suppress = 1; 

) 


Check the value of these display-control variables in a CONDITIONS block 


CONDITIONS: RCV INFO 
{ 

I2_enhance == 1 

) 

ACTIONS: 

{ 

I2_enhance = 0; 

1 

or an ACTIONS block: 


CONDITIONS: RCV INFO 
ACTIONS: 

{ 

if(l2_enhance -= 1) 
I2_enhance = 0; 

) 


76.3 Routines 

Use the following routines in emulate mode only. If you try to call one of these 
routines in monitor mode, you will be returned to the main program menu. When 
you go to the Protocol Spreadsheet and search for errors, a message like the 
following will be displayed: “ Error 140: Unresolved reference 12 _ J give_data.” 
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(A) Receive 
I2_give_data 

Synopsis 

extern void I2_give_data(); 

Description 

The I2_give_data routine takes takes an interlayer message buffer associated with 
a received INFO frame, changes the SDU offset to point to higher-level data, 
and sends a DL_DATA IND primitive up to Layer 3 along with a reference to 
this buffer. The softkey equivalent of this routine is the GIVE_DATA action on the 
Protocol Spreadsheet. 

Example 

Layer 3 wants access to the line in order to receive and send data. Assuming 
the SDLC personality package is loaded at Layer 2, enter the following program: 

LAYER: 2 

STATE: datallnk 

CONDITIONS: DL_CONNECT REQ / 

ACTIONS: DL_CONNECT CONF l 

CONDITIONS: DL_DATA REQ 
ACTIONS: SEND INFO “((DL DATAI) " 

CONDITIONS: RCV INFO 
ACTIONS: 

{ 

I2_give_data (); 

1 

(B) Transmit 
resencMtame 

Synopsis 

extern void resend Jramefpf, first_or_next) ; 

unsigned char pf; 

unsigned char first _or_next; 

Description 

The resend_frame routine will resend either the first or next frame in the 
window with the P/F bit set to a specified value. 

NOTE: To ensure that this routine executes properly, select 

Emulation Addressing: , POiNT-TOippwr : on the SDLC Frame Level 

Setup screen. For either point-to-point or multi-drop operation, 

see resend Jramejnidti. ( 
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Inputs 

The first parameter is the value of the P/F bit in the frame. It may be set to 
either zero or one. 

The second parameter indicates whether the first frame in the window will be 
sent, or whether the next frame in the window will be sent. The first resend 
action will send the first frame in the window regardless of whether first or next 
has been selected. Legal entries are 0 (first) or 1 (next). 

Example 

Suppose you want to resend the entire transmit window if you receive a REJ 
frame, 

LAVER: 2 

STATE: xfer 

/* Whatever conditions and actions send data precede the following condition. */ 

CONDITIONS: RCV REJ RESP 
NEXT_STATE: recover 
STATE: recover 

CONDITIONS: ENTER_STATE 
ACTIONS: 

{ 

resend _frame(l, 0); 

) 

CONDITIONS: FRAMESENT 
MORE_TO_RESEND 
ACTIONS: 

< 

resend Jrame(l ,1); 

} 

CONDITIONS: FRAME_SENT 
NO_MORE_T 0_R E S EN D 
NEXT STATE: xfer 


resend_frame_multl 

Synopsis 

extern void resend _frame_multi(pf, jirst_or_next, addr_value); 

unsigned char pf; 

unsigned char first _or_next; 

unsigned char addr_yalue; 

Description 

The resend Jramejnulti routine will resend either the first or next frame in the 
window to a specified controller address. The softkey equivalent of this routine 
is the (PROTOCL) RESEND action on the Protocol Spreadsheet. 

NOTE: For multi-drop operation, select Emulation Addressing: 

' MULTI-DROP -J?" on the SDLC Frame Level Setup screen. 
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Inputs 

The first parameter is the value of the P/F bit in the frame. It may be set to 
either zero or one. 

The second parameter indicates whether the first frame in the window will be 
sent, or whether the next frame in the window will be sent. The first resend 
action will send the first frame in the window regardless of whether first or next 
has been selected. Legal entries are 0 (first) or 1 (next). 

The third parameter is the value of the controller address. The specified address 
must be listed- in the addr table on the SDLC Frame Level Setup screen (see 
Section 38.1). Values in the decimal range 0 through 255 are valid. Value may 
be represented as decimal, hexadecimal, or octal. For loopback, use the 
variable rcvd _frame_addr. 

Example 

Suppose you want to resend the entire transmit window for the controller address 
in a received REJ frame. 

{ 

extern volatile const unsigned char rcvd _Jrame_addr; 

) 

LAYER: 2 (' 

STATE: xfer 

/* Whatever conditions and actions send data precede the following condition. */ 

CONDITIONS: RCV REJ RESP 
NEXT_STATE: recover 
STATE: recover 

CONDITIONS: ENTER_STATE 
ACTIONS: 

{ 

resend _Jrame_mutti(] , 0, rcvd _frame_addr); 

} 

CONDITIONS: FRAME_SENT 
M OR E_T 0_RE SE NO 
ACTIONS: 

{ 

resend _frame(l ,1 , rcvd _ frame_addr ) ; 

) 

CONDITIONS: FRAME_SENT 
NO_MORE TO_RESEND 
NEXT_STATE: xfer 

reset_nr 

Synopsis 

extern void reset _nr(); 

Description 

This routine resets the N(R) field in information and supervisory frames to zero. ( 
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NOTE: To ensure that this routine executes properly, select 
Emulation Addressing: on the SDLC Frame Level 

Setup screen. For either point-to-point or multi-drop operation, 
see reset _nr_multi. 

Example 

When a link is established, reset N(R). 

LAYER: 2 

STATE: reset 

CONDITIONS: ENTER^STATE 
ACTIONS: SEND SABM 
CONDITIONS: RCV UA 
ACTIONS: 

{ 

reset_nr(); 

) 


reset_nr jnulti 

Synopsis 

extern void resel_nr_multi(addr_value); 
unsigned char addr_value; 


Description 

This routine resets to zero the N(R) field in information and supervisory frames 
for a specified controller address. The softkey equivalent of this routine is the 
(PROTOCL) rset_nr action on the Protocol Spreadsheet. 


NOTE: For multi-drop operation, select Emulation Addressing: 
!! multi-drop on the SDLC Frame Level Setup screen. 


Inputs 

The only parameter is the value of the controller address. The specified address 
must be listed in the ADDR table on the SDLC Frame Level Setup screen (see 
Section 38.1). Values in the decimal range 0 through 255 are valid. Value may 
be represented as decimal, hexadecimal, or octal. For loopback, use the 
variable rcvd _frame_addr. 
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Example 


When a link is established, reset N(R) for address in received UA frame. 


extern volatile const unsigned char rcvd _frame_addr; 

} 

LAYER; 2 

STATE: reset 

CONDITIONS; ENTER_STATE 
ACTIONS; SEND SABM 
CONDITIONS; -RCV UA 
ACTIONS: 

reset _nr_multl (rcvd Jrame_addr)\ 

} 


reset ns 


Synopsis 


extern void reset_ns(); 


Description 


The N(S) field in information frames is reset to zero and the transmit window is 
cleared. 


NOTE: To ensure that this routine executes properly, select 
Emulation Addressing: 'fcOINT-TO-POiMT on the SDLC Frame Level 
Setup screen. For either point-to-point or multi-drop operation, 
see reset ns multi. 


Example 

When a link is established, reset N(S). 


LAYER: 2 

STATE: reset 

CONDITIONS: ENTER_STATE 
ACTIONS: SEND SABM 
CONDITIONS: RCV UA 
ACTIONS: 

{ 

reset ns(); 

) 
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resetjis multi 

Synopsis 

extern void reset_ns_multi(addr_value); 
unsigned char addr_value; 

Description 

This routine resets to zero the N(S) field in information frames for a specified 
controller address. It also clears the transmit window. The softkey equivalent of 
this routine is the (PROTOCL) RSETNS action on the Protocol Spreadsheet. 

NOTE: For multi-drop operation, select Emulation Addressing: 

' MtovoftoF 1 on the SDLC Frame Level Setup screen. 


Inputs 

The only parameter is the value of the controller address. The specified address 
must be listed in the ADDR table on the SDLC Frame Level Setup screen (see 
Section 38.1). Values in the decimal range 0 through 255 are valid. Value may 
be represented as decimal, hexadecimal, or octal. For loopback, use the 
variable rcvd _frame_addr. 

Example 

When a link is established, reset N(S) for address in received UA frame. 

{ 

extern volatile const unsigned char rcvd Jrame_addr; 

) 

LAVER: 2 

STATE: reset 

CONDITIONS: ENTER_STATE 
ACTIONS: SEND SABM 
CONDITIONS: RCV UA 
ACTIONS: 

{ 

rese t_n s_mul ti (rcvd Jr a me _addr); 

) 

sendframe 

Synopsis 

extern void sendjrame(il_buffer_number, relay _baton, data siart ^offset , transmit Jrame_plr) ; 
unsigned short il_buffer_number; 
unsigned short relay _baton; 
unsigned short data_start_offset; 
struct send Jrame_structure 
{ 

unsigned char addrjype; 
unsigned char frame Jype; 
unsigned char nr_lype; 
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unsigned char nsjype; 
unsigned char p _fjype; 
unsigned char bccjype; 
unsigned char addr_value; 
unsigned char cntrlbyte; 
unsigned char nr_value; 
unsigned char ns value; 

); 

struct send Jramejtructure * transmit Jrame _ptr; 

Description 

The send Jrame routine adds a frame-level header to an interlayer message 
buffer and passes the buffer to Layer 1, The softkey equivalent of this routine is 
the SEND action on the Protocol Spreadsheet. 

Inputs 

The first parameter is the interlayer message buffer number. See Section 
66.3(A), Layer-Independent OSI routines. 

The second parameter is the maintain bit used to hold the buffer while the send 
operation is being performed. See Section 66.3(A). 

The third parameter is the offset from the beginning of the buffer to the start of 
the service data unit. See Section 66.3(A). ( 

The fourth parameter is a pointer to the frame structure to be sent. For a 
description of send Jrame _structure see Table 76-1. 

Example 

Send an Info frame containing a canned fox message and a good BCC onto the 
line. 

{ 

static unsigned short ilbufferjtumber; 
static unsigned short relay baton; 
static unsigned short data_startj)ffset; 
struct send J'ramejtructure 
{ 

unsigned char addrjype; 
unsigned char frame Jype; 
unsigned char nr Jype; 
unsigned char nsjype; 
unsigned char p^fjype; 
unsigned char bccjype; 
unsigned char addrjvalue; 
unsigned char cntrljayte; 
unsigned char nr_value; 
unsigned char ns value; 

); 

struct send Jrame_structure transmit J^rame; 
static char transmitjtring {] = "(( FOX'S)”; 

) i 
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LAYER: 2 

STATE: send_a_frame 

CONDITIONS: KEYBOARD “ " 

ACTIONS: 

{ 

_get_il_msg_buff(&il_buffer_number, &relay_balon); 

_start_il buff list (il_buffer_number, &data_start_offset) ; 
transmit _frame.bcc_type = I; 

Jnsert_il_buffJist_cnt(il_buffer_number, datastartjoffset, &transmit_string[0] , 
(sizeof(transmit_string) - 1)); 

send_frame(U_buffer_number, relaybaton, datajstartjaffset, &transmit frame ); 

) 
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When the SNA package is loaded in via the Layer Setup screen, the following external 
variables become available for use by the programmer. Their use on the Protocol Spreadsheet 
is not limited to any particular layer, though normally they belong at Layer 2. 

SDLC variables and routines, while they are included in the SNA layer-personality package, 
are not documented here. They are documented fully in Section 76. 

Those variables that are specific to the SNA package are documented here. They pertain to 
fields in SNA transmission headers, request/response headers, and request/response units. 
These variables have no spreadsheet-token equivalents. 

77.1 Structures 

Use the SDLC send_frame_structure shown in Table 76-1. 

77.2 Variables 

The variables discussed below apply when the Line Setup menu shows either emulate 
or monitor mode. Emulate mode, however, is not supported by emulate-only 
conditions and actions on the Protocol Spreadsheet. 

(A) Monitoring Events 

Use the SDLC event variables discussed in Section 76.2(A). 

(B) Status Variables 

All SNA variables in Table 77-1 are status variables. Also refer to the SDLC 
status variables listed in Table 76-2. 

There are no softkey tokens on the spreadsheet that are equivalent to the SNA 
variables listed in Table 77-1. To search for Info frames with a FID2 
transmission header, for example, use C variables. The condition should look 
like this: 

CONDITIONS: 

{ 

die Jrame && (m_frame_type -- 0) <&& (m jacket _ fid type — 2) 

) 
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Table 77-1 
SNA Varlablesf 


Type 

Variable 

Value (hex/decimal) Meaning 

extern volatile unsigned short 

m_packetjength 


Length of the packet, Including 
the transmission and 
request/response headers. Line 
Setup configured for emulate or 
monitor mode. 


Transmission Header: 



extern volatile const unsigned char 

m_packet_fld_type 

0 

Format Identification Tvoe: 
FIDO; TH 10 bytes 



1 

FiDI ; TH 10 bytes 



2 

FID2; TH 6 bytes 



3 

FIDS; TH 2 bytes 



4 

FID4; TH 26 bytes 



f/15 

FIDF; TH 26 bytes 




Line Setup configured for 
emulate or monitor mode. 

extern volatile const unsigned short 

m packet daf 

0-1 Iff 10-65535 

Destination address field— 2 



bytes In FIDO and FIDI; 1 byte 
In FID2 , Line Setup configured 
for emulate or monitor mode. 



extern volatile const unsigned short 

m packet def 

0-flfll0-65535 

Destination element field— 2 



bytes; FID4 only, Line Setup 
configured for emulate or 
monitor mode. 



extern volatile const unsigned long 

m packet dsaf 

O-lffflfftl 

Destination subarea address 


0-429496729 5 

field— 4 bytes; FID4 only. 


Line Setup configured for 
emulate or monitor mode 


extern volatile const unsigned char 

m_packet_lsld 

(actual value 

Local Session Identification: 
FID3 only 
SSCP-PU session 



ol byte) 

SSCP-LU session 
Reserved 
LU-LU session 




Line Setup configured for 
emulate or monitor mode. 

extern volatile const unsigned short 

m_packet_oaf 

00-1(10-255 

Origin address field— 2 bytes In 


FIDO and FID1; 1 byte In FID2, 
Line Setup configured for 
emulate or monitor mode. 


extern volatile const unsigned short 

m_packet_oef 

00-11/0-255 

Origin element field— 2 bytes; 
FID4 only. Line Setup 
configured for emulate or 
monitor mode. 

extern volatile const unsigned long 

m packet osaf 

0-flll(t((l 

Origin subarea address field— 4 


0-4294967295 

bytes; FID4 only. Line Setup 
configured for emulate or 





monitor mode. 


f Refer to Table 76-2 for SDLC variables. 
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Table 77-1 (continued) 


Type 

Variable 

Value (hex/decimal) Meaning 


Transmission Header (continued): 


extern volatile unsigned char * 

th_ptr 


Pointer for the transmission 
header; begins at the byte 
containing FID type. Line Setup 
configured for emulate or 
monitor mode. 


Reauest/ResDonse Header: 


extern volatile const unsigned char 

m_packet_ru_category 

0 

Reouest/ResDonse Unit: 
Function Management Data 
(FMD) 



20/32 

Network Control (NC) 



40/64 

Data Flow Control (DFC) 



60/96 

Session Control (SC) 




Line Setup configured for 
emulate or monitor mode. 

extern volatile const unsigned char 

m_packet_fl 

0 

Format Indicator: 

User data without header In RU 



8 

In LU-LU frame, Indicates 
header follows the RH, In SC. 
NC, or DFC RU, Indicates a 
formatted RU beginning with a 
request code. 

Line Setup configured for 
emulate or monitor mode. 

extern volatile const unsigned char 

m_packet_rrl 

0 

Reouest/ResDonse Indicator: 
request 



80/128 

response 




Line Setup configured for 
emulate or monitor mode. 

extern volatile unsigned char 

m_packet_rtl 

0 

Sg3R£nse Type indicator: 
positive response 



10/16 

negative response 
Line Setup configured for 
emulate or monitor mode. 

extern volatile unsigned char 

m_packet_sd! 

0 

Sense Data Indicator; 
sense data not Included 



4 

sense data Included 




Line Setup configured for 
emulate or monitor mode. 

extern volatile unsigned char * 

rh_ptr 


Pointer for the request/response 
header; begins at the byte 
containing the request/response 
Indicator. Line Setup configured 
for emulate or monitor mode, 

extern volatile unsigned char * 

Reouest/ResDonse Unit: 
ru ptr 


Pointer for the request/response 



unit; begins at the first byte In 
the unit. Line Setup configured 
for emulate or monitor mode. 
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1. Info frame characteristics. Most status variables in Table 77-1 contain an 
m_ prefix, indicating that they are valid in emulate or monitor mode. Some 
variables are associated with the transmission header: m jacket _fid_type, 

m jacket daf, m jacket_def, m jacket_dsaf, m jacket Jsid, m jacket jaf, 
m jacket jef, and m jacket jsaf. Other variables are associated with the 
request/response header: m jacket jujate gory , m jacket _fi, m jacket _rri, 
m jacket _rti, and m jacket_sdi. 

2. Pointers. There are three pointers to SNA fields, th jtr points to first byte 
of the transmission header, rh jtr points to the first byte of request/response 
header, and ru jtr points to the start of the request/response unit. 


(C) Controlling Protocol Trace Display 

To enhance or suppress particular packets on the Layer 2 Protocol Trace screen 
in emulate or monitor mode, assign a coded value to I2_enhance or I2_suppress. 
The values are listed in Table 76-2. To assign a value to either of these 
variables, place the statement in an ACTIONS block. For example, display only 
Info frames with FID2 transmission headers. Of these, display frames with sense 
data in reverse-video. 

CONDITIONS: 

{ 

dte Jame && (m Jame_type == 0) && (m _packet Jd_type /= 2) 

) 

ACTIONS: 

{ 

12 suppress = /; 

) 

CONDITIONS: 

{ 

die Jame && (m JameJype == 0) && (m jacket Jd_type == 2) && (m jacket sdi -- 4) 

} 

ACTIONS: 

{ 

I2_enhance = 1; 

) 


Check the value of these display-control variables in a CONDITIONS block 


CONDITIONS: 

{ 

dte Jame &.& (m Jame_type - = 0) Act (m jacket Jd_type t- 2) && (I2_suppress == 0) 

} ' 

ACTIONS: 

{ 

I2_suppress = 1; 

} 
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or an ACTIONS block: 


CONDITIONS: 

{ 

die _Jrame && (m _Jrame_type == 0) && (m _ packet _fid_lype /= 2) 

) 

ACTIONS: 

{ 

if(12_suppress == 0) 

I2_suppress = /; 

} 


77.3 Routines 

There are no routines associated exclusively with SNA. Use the SDLC routines 
discussed in Section 76.3. To send a frame including SNA protocol, for example, 
include a transmit _string of SNA data in the send _frame routine. 
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78 DDCMP Library 


When the DDCMP package is loaded in via the Layer Setup screen, the following external 
variables become available for use by the programmer. Their use on the Protocol Spreadsheet 
is not limited to any particular layer, though normally they belong at Layer 1. 


78.1 Structures 


There are no extern structures associated exclusively with DDCMP. 


78.2 Variables 


The only variables exclusive to DDCMP relate to block checking. When the 
DDCMP package is loaded in, the results of both header and data block checks are 
displayed on the data screen. If you want your program to detect good or bad 
BCC's, you may use the BCC selections on the trigger menus and at Layer 1 of the 
Protocol Spreadsheet to interrogate the header block check only. 


If you want to detect a good or bad data block check, you must use one of the C 
event variables listed in Table 78-1. 


Here is a program that counts bad DTE BCC’s for both header and data: 


{ 

extern fast_event fevar_bd _bcc2 _td; 

) 

LAYER: 1 

STATE: count_all_bad_dte_bccs 
CONDITIONS: DTE BAD BCC 
ACTIONS: COUNTER t_bdbcc INC 
CONDITIONS: 

{ 

fevar_bd_bcc2 Id 

} 

ACTIONS: COUNTER t bdbcc INC 


78.3 Routines 


There are no routines associated exclusively with DDCMP. 
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Table 78-1 
DDCMP Variables 


Type 

Variable 

Value (hex/decimal) Meaning 

extern fast_event 

fevar_gd_bcc_rd 

True when a good header BCC 
Is received on RD. Line Setup 
configured for emulate or 
monitor mode. 

extern fast_event 

fevar_gd_bcc_td 

True when a good header BCC 
Is received on TD. Line Setup 
configured for emulate or 
monitor mode. 

extern fast_event 

fevarjjd_bcc_rd 

True when a bad header BCC Is 
received on RD. Line Setup 
configured for emulate or 
monitor mode. 

extern fast_event 

fevar_bd_bcc_td 

True when a bad header BCC Is 
received on TD. Line Setup 
configured for emulate or 
monitor mode. 

extern fast_event 

fevar_gd_bcc2_td 

True when a good data BCC Is 
received on TD, Line Setup 
configured for emulate or 
monitor mode, 

extern fast_event 

fevar_gd_bcc2_/d 

True when a good data BCC Is 
received on RD. Line Setup 
configured for emulate or 
monitor mode. 

extern fast_event 

fevar_bd_bcc2_td 

True when a bad data BCC Is 
received on TD. Line Setup 
configured for emulate or 
monitor mode. 

extern fastevent 

fevar_bd_bcc2j-d 

True when a bad dafa BCC Is 
received on RD. Line Setup 
configured for emulate or 
monitor mode. 
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79 ISDN D Channel Library 

To use the C structures, variables, and routines explained in this section, your INTERVIEW 
must be equipped with Option 15. Install the ISDN Test Interface Module (TIM) in the rear 
of the INTERVIEW, as explained in Section 12. Also install the ISDN mux board according 
to the directions in Appendix J4. Load in the ISDN_D Layer 1 package via the Layer Setup 
screen. The ISDN_D package contains the variables and most of the routines documented 
below. Finally, select one of the B channels in the Channel field on the ISDN Interface 
Setup screen. See Section 51.5. 

The configuration of the INTERVIEW described above supports dual-channel monitoring. 
Dual-channel monitoring means tracking one of the B channels and the D channel. All 
menu selections (with the possible exception of Speaker on the ISDN Interface Setup menu), 
triggers, and spreadsheet conditions and actions apply to the B channel selected. Use the C 
structures, variables, and routines in this section to monitor the D channel. 

NOTE: When the ISDN Interface Setup screen shows Channel: 
o , your unit is configured for single-channel monitoring. 

Menu selections, triggers, and the Protocol Spreadsheet apply to 
the D channel. Do not load in the ISDN_D Layer 1 package. 

You may develop your own program to monitor the D channel, or simply load and run the 
program contained in the ISDN trace application package (available as OPT-951-35). 

79.1 Structures 

Use the structure xmitjisl, shown in Table 79-1, when transmitting on the D channel 
via the send_d_frame routine. Refer to send_d J frame in Section 79.3 for an 
example of how to use this structure. 

Table 79-1 
ISDN Structures 


Type 

Variable 

Value (hex/decimal) 

Meaning 

Structure Name: 

: xmit_llst 


Structure of a transmit list for send_d_frame 
routine. Declared as type struct. Reference 
member variables of the structure as follows: 
xmltjlst .strlngjength . 

unsigned char * 

string 


pointer to the location of the transmit string— the 
transmit string Is declared separately 

unsigned short 

strlngjength 

O-t/fflO-65535 

length of the transmit string 
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79.2 Variables 

There are three event variables associated with the ISDN_D personality package. 

They are d_dte Jrame, djice Jrame, and d_rcv J'rame. See Table 79-2. 

(A) Monitoring Events 

1. In monitor mode. When a frame is detected on the D channel, one monitor 
event, d_dce J'rame or d_dte Jrame, is signaled. Use both event variables to 
construct an ISDN trace. 

2. In emulate mode. In emulate mode, the receive event d_rcv Jrame and one 
of the monitor events are signaled when a frame is received on the D 
channel. The INTERVIEW'S transmissions on the D channel may not be 
monitored when the unit is in dual-channel mode. The implication of this 
difference is that ISDN trace programs written in monitor mode may not be 
placed intact in an emulation program. 


Table 79-2 
ISDN Variables 


Type 

Variable 

Value (hex/decimal) Meaning 

extern event 

d_dte_frame 

True when a DTE frame Is 
detected on the D channel. 
Line Setup configured for 
emulate or monitor mode. 

extern event 

d_dce_frame 

True when a DCE frame Is 
detected on the D channel. 
Line Setup configured for 
emulate or monitor mode. 

extern event 

d_rcv_fra me 

True when a frame Is received 
on the D channel. Line Setup 
configured for emulate mode 
only. 


79.3 Routines 

There are two routines associated with the ISDN_D package: send_d Jrame and 
send_d Jrame Jl. Another ISDN routine, set _isdn_speaker _chan, controls the 
speaker for either of the B channels. This routine is supplied by the ISDN Test 
Interface Module. 

(A) Transmit 

Use the following routines in emulate mode only. If you try to call one of these 
routines in monitor mode, you may be returned to the main program menu. 
When you go to the Protocol Spreadsheet and search for errors, a message like 
the following may be displayed: "Error 140: Unresolved reference 
sendd Jrame Jl . " 
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send_d_frame 

Synopsis 

extern void send_d _Jrame(count, struct jendjstringjtr, xmit_tag ); 
unsigned short count; 
struct xmitjist 
{ 

unsigned char * slring_ptr; 
unsigned short stringjength; 

); 

struct xmitjist * struct_send_string_ptr; 
unsigned short xmit Jag; 


Description 

The send_dj'rame routine sends a specified string on the D channel with a 
user-determined BCC. 


inpins 

The first parameter is the number of strings to be sent. 

The second parameter is a pointer to a structure which in turn identifies the 
location and length of each string. 

The third parameter is a transmit tag which includes a BCC in bits 0-2: good 

(001) , bad (010), or abort (Oil). Bits 3-7 are reserved for future use. 
Integers may be used to indicate the value of the transmit tag: good (1), bad 

(2) , and abort (3). 


Example 

Assume you want to send on channel D a fox message inside of an X.25 data 
packet with a good block check. You might have 2 strings, one with the Layers 
2 and 3 header information, and one with the fox message. You would send 
these strings as follows: 

{ 

unsigned char headers [) - {0x01, 0x00, 0x10, 0x04, 0x00}; 
unsigned char message (] = "(.(FOX)) 
struct xmit list 
{ 

unsigned char * string; 
unsigned short stringjength; 

).- 

struct xmit list send_string [] = { &headers[0] , 5, &messagelO], sizeof (message) - 1); 

) 
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LAVER; 1 

STATE; send_message 

CONDITIONS: KEYBOARD “ ” 

ACTIONS: 

{ 

send d Jrame(2, &send_strlng[0], 1); 

} 

send_d_frame_il 

Synopsis 

extern void send_d _Jrame_il(il_buffer_number, relay_baton, data_start_offset, transmit Jag); 

unsigned short il_buffer_number; 

unsigned short retayjbaton; 

unsigned short data_start_offset; 

unsigned short transmitjag; 

Description 

This routine sends a designated interlayer message buffer out on the D channel. 
Inputs 

The first parameter is the interlayer message buffer number. 

The second parameter is the maintain bit used to hold the buffer while the send 
operation is performed at Layer 1. 

The third parameter is the offset from the beginning of the buffer to the service 
data unit (SDU). 

The fourth parameter is a transmit tag which includes a BCC in bits 0-2: good 

(001) , bad (010), or abort (011). Bits 3-7 are reserved for future use. 

Integers may be used to indicate the value of the transmit tag: good (1), bad 

(2) , and abort (3). 

Example 

Send the same text as in the example for send_d J'rame. Refer to Section 
66.3(A) for a description of the _get_il_msg_buff, _startjl_buffjist, and 
Jnse rt_il_buff_list_cnt routine s . 


{ 

unsigned short ii_buffer_number ; 
unsigned short relay_baton; 
unsigned short data_slart_o/fset ; 

unsigned char message [] = ‘' 0 i\xOOO l o°t\xOOO(.(.FOX)) " ; 

} 
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LAYER'. 1 

STATE: sendmessase 

CONDITIONS: KEYBOARD “ " 

ACTIONS: 

{ 

_get_il_msg_buff(&i l_buffer_n urn ber, & rel ay_ba ton); 

_s tart_i l_buff_list ( ll_bu/fer_n umber, &da ta_s tart _off set); 
_insertjl_buffjist_cnt(il_buffer_number, data _start_off set, &message/OJ, 
(sizeof (message) - l)); 

send_d_framell(il buffer_number, relay _baton, data_start_offset, 1); 

) 


(B) Speaker Control 

set_isdn_speaker_chan 

Synopsis 

extern void set_isdn_speaker_chan(selection); 
unsigned short selection; 

Description 

The set_isdn_speaker_chan routine allows the programmer to control the speaker 
located on the ISDN mux board, Option 15. The programmer may enable the 
speaker for one of the B channels. This selection is independent of the channel 
selected for monitor or emulation on the ISDN Interface Setup screen. 

Inputs 

The only parameter is the channel selection. A value of one means turn the 
speaker on for channel Bl. Enable the speaker for channel B2 with two. Turn 
the speaker off by setting the value to zero. 

Example 

Suppose you want to know whether data or voice is being transmitted over 
channel Bl. Use the setjsdn_speak.er_chan routine to enable the speaker for 
Bl. Even if you are otherwise using the INTERVIEW to monitor B2, you will 
hear the Bl transmissions. 

LAYER: 1 

STATE: enable_b1 

CONDITIONS: KEYBOARD “sS" 

ACTIONS: 

set_isdn_speaker_chan(l ); 

} 
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80 LAPD Library 

When the LAPD package is loaded in via the Layer Setup screen, the following external 
routines and variables become available for use by the programmer. Their use on the 
Protocol Spreadsheet is not limited to any particular layer, though normally they belong at 
Layer 2. 

The variables and routines approximate LAPD Layer 2 spreadsheet-generated conditions and 
actions. Refer to Section 42 for more detailed explanations of the purposes of specific 
conditions and actions. Sometimes the name of the variable or routine is sufficient for 
identifying its related spreadsheet token. When this is not the case, the information is 
provided below. 

80.1 Structures 

The structure send _frame_structure defines the format of transmitted LAPD frames. 
See Table 80-1. Use this structure to send frames via the send _Jrame routine in 
emulate mode. See Section 80.3(B). Each variable in the structure relates to some 
softkey selection or user entry in the SEND action. 

80.2 Variables 

(A) Monitoring Events 

1. Emulate or monitor mode. LAPD events include frames detected, good or 
bad BCC’s, and aborts. All event variables in Table 80-2 containing a dte_ 
or dce_ prefix are valid in either emulate or monitor mode. These event 
variables are dte_frome, dce_frame, dte_j>ood_bcc, dce_good_bcc, 
dte_bad_bcc, dce_bad_bcc, dte_abort, dce_abort. The variable 
dce_good_bcc, for example, equates to DCE GDBCC. 

You can use both die and dee variables relating to the same event in one 
conditions block. Suppose you want to count all bad BCC’s from either side 
of the line. Enter the following CONDITIONS/ACTIONS block: 

CONDITIONS: 

{ 

dte_bad_bcc | | dce_bad_bcc 

) 

ACTIONS: COUNTER bad bcc INC 
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Table 80-1 
LAPD Structures 


Type 

Variable 

Value (hex/decimal) 

Meaning 

Structure Name: 

send_frame 

structure 

Structure of a frame In LAPD. Declared as type 
struct. Declared automatically If a 
softkey-entered SEND action Is taken. Program 
frames assigned to structure as follows: struct 
send_frame_structure name. Reference a 
structure variable as follows: name.bcc_type. If 
values In the frame structure are not Initialized by 
the user, they default to 0. You may Initialize the 
values when the structure Is declared: 
struct send_frame_structure name = {1, 1 , 2, 0, 
0, 0, 1, 1, 1, 0, 0, 0}; 


unsigned char 

sapltype 

1 

no other value valid— Indicates a value Is given 

unsigned char 

teltype 

1 

no other value valid— Indicates a value Is given 

unsigned char 

cr_type 

0 

1 

2 

0 

1 

loopback 

unsigned char 

frame_type 

(The codes lor frame_type are (he same as for the LAPD-variable 
rcvdjramejype . ) 

unsigned char 

nr type 

0 

auto 



1 

value 



2 

received ns plus 1 



3 

last nr sent 

unsigned char 

ns type 

0 

auto 



1 

skip 



2 

last nr received 



3 

value 

unsigned char 

p f type 

0 

1 

2 

0 

1 

loopback 

unsigned char 

bcc type 

0 

default (bad bcc) 



1 

good bcc 



2 

bad bcc 



3 

abort 

unsigned char 

saplvalue 

00-3 f 10-63 


unsigned char 

te l_value 

00-7110-127 


unsigned char 

cntrlbyte 

(actual value of the control byte) 

unsigned char 

nr_value 

0-7 (MOD 8) 

If nr type = 1 

unsigned char 

ns_value 

0-7 (MOD 8) 

If ns_type = 3 
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Table 80-2 
LAPD Variables 


Type Variable Value (hex/decimal) Meaning 


extern event 

dte_frame 

True when a DTE frame Is 



detected. Line Setup 
configured for emulate or 
monitor mode. 

extern event 

dce_frame 

True when a DCE frame Is 



detected. Line Setup 
configured for emulate or 
monitor mode. 

extern event 

dte_good_bcc 

True when a good BCC Is 



calculated for a DTE frame. 
Line Setup configured for 
emulate or monitor mode. 

extern event 

dce_good_bcc 

True when a good BCC is 
calculated for a DCE frame. 
Line Setup configured for 
emulate or monitor mode. 

extern event 

dte_bad_bcc 

True when a bad BCC Is 



calculated for a DTE frame. 
Line Setup configured for 
emulate or monitor mode. 

extern event 

dcebadbcc 

True when a bad BCC Is 



calculated for a DCE frame. 
Line Setup configured for 
emulate or monitor mode. 

extern event 

dte_abort 

True when an abort Is detected 



for a DTE frame. Line Setup 
configured for emulate or 
monitor mode, 

extern event 

dce_abort 

True when an abort Is detected 



for a DCE frame. Line Setup 
configured for emulate or 
monitor mode. 

extern event 

rcvd_frame 

True when a frame Is received. 



Line Setup configured for 
emulate mode only. 

extern event 

lnva!id_frame 

True when an Invalid frame Is 



detected. Line Setup 
configured for emulate mode 
only. 

extern event 

I2_T1 

True when the T1 timeout-timer 



has expired. Line Setup 
configured for emulate mode 
only. 

extern event 

bcc_error 

True when a BCC error Is 



detected. Line Setup 
configured for emulate mode 
only. 

extern event 

nr_error 

True when an N (R) error Is 



detected In a received INFO or 
supervisory frame. Line Setup 
configured for emulate mode 
only. 

extern event 

nserror 

True when an N(S) error Is 


detected In a received INFO 
frame. Line Setup configured 
for emulate mode only. 
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Table 80-2 (continued) 


Type 


Variable Value (hex/decimal) Meaning 


extern event 

frame_sent 


True when frame Is passed 
down to Layer 1 . Line Setup 
configured for emulate mode 
only. 

extern volatile const unsigned char 

m_frame_addr_sapl 

00-31/0-63 

Line Setup configured for 
emulate or monitor mode. 

extern volatile const unsigned char 

m_frame_addr_tel 

00-7 NO- 127 

Line Setup configured for 
emulate or monitor mode. 

extern volatile const unsigned char 

m_frame_addr_cr 

0 

1 

0 

1 

Line Setup configured for 
emulate or monitor mode. 

extern volatile const unsigned char 

m_frame_type 

(same as rcvdJramejype—Une Setup 
configured for emulate or monitor mode) 

extern volatile const unsigned char 

m_frame_cntrl_byte_1 

(actual value of control byte— Line Setup 
configured lor emulate or monitor mode) 

extern volatile const unsigned char 

m_frame_pf 

0 

10/16 

pf=0 

pf=1 

Line Setup configured for 
emulate or monitor mode. 

extern volatile const unsigned char 

m_frame_bcc_type 

1 

2 

3 

good 

bad 

abort 

Line Setup configured for 
emulate or monitor mode. 

extern volatile const unsigned char 

m_frame_nr 

0-7 (MOD 8) 

Line Setup configured for 
emulate or monitor mode. 

extern volatile const unsigned char 

m_frame_ns 

0-7 (MOD 8) 

Line Setup configured for 
emulate or monitor mode. 

extern volatile const unsigned char 

rcvd_frame_addr_sapl 

00-3110-63 

Line Setup configured for 
emulate mode only. 

extern volatile const unsigned char 

rcvd_frame_addr_tel 

00-7f/0-1 27 

Line Setup configured for 
emulate mode only, 

extern volatile const unsigned char 

rcvd_frame_addr_cr 

0 

1 

2 

0 

1 

loopback 

Line Setup configured for 
emulate mode only. 

extern volatile const unsigned char 

rcvd_frame_type 

0 

1 

3 

5 

9 

21/37 

6f/1 1 1 

43/67 

f/1 5 

f/15 

63/99 

67/103 

87/135 

e7/224 

ff/255 

ff/255 

Info 

rr 

ul 

rnr 

re) 

sabm 

sabme 

disc 

dm 

sarm 

ua 

slo 

frmr 

sll 

other 

unknown 

Line Setup configured for 
emulate mode only. 
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Table 80-2 (continued) 


Type 


Variable Value (hex/decimal) Meaning 


extern volatile const unsigned char 
extern volatile const unsigned char 


extern volatile const unsigned char 


extern volatile const unsigned char 
extern volatile const unsigned char 
extern volatile unsigned short 


extern volatile unsigned short 


extern volatile unsigned short 


extern volatile unsigned short 


extern volatile unsigned short 
extern volatile unsigned short 
extern volatile unsigned short 


rcvd_frame_cntrl_byte_1 (actual value of control byte— Line Setup 

configured for emulate mode only) 
rcvd_frame_pf 0 pf=0 

10/16 pf=1 

Line Setup configured for 
emulate mode only. 


rcvd_frame_bcc_type 1 good 

2 bad 

3 abort 

Line Setup configured for 
emulate mode only. 


rcvd_frame_nr 0-7 (MOD 8) Line Setup configured for 

emulate mode only. 


rcvdframens 0-7 (MOD 8) Une Setup configured for 

emulate mode only. 


rcvd_frame_buff_seg 


rcvd frame sdu offset 


rcvd frame sdu size 


l2_current_wlndow_edge 


l2_lo we r_wl ndo w_e dg e 
l2_upper_wlndow_edge 
I2_resend_edge 


Inter-layer message buffer 
number (actually, an IAPX-286 
segment number) In a received 
frame, This segment number 
can be converted to a pointer 
by shifting It left 16 bits. Line 
Setup configured for emulate 
mode only, 

Offset to where the service data 
unit begins In an Inter-layer 
message buffer In a received 
frame. Add to buffer segment 
number (converted to pointer) 
to point to first byte In frame, 
Line Setup configured for 
emulate mode only. 

Size of service data unit in a 
received frame. Line Setup 
configured for emulate mode 
only. 

When equal to upper edge, 
window Is full; when equal to 
lower edge, window Is empty; 
when not equal to upper edge, 
window Is not full; and when not 
equal to lower edge, window Is 
not empty, Line Setup 
configured for emulate mode 
only, 

see I2_ourrent_wlndow_edge 
see l2_current_wlndow_edge 

When resend edge Is not equal 
to lower window edge, there Is 
more to resend; when resend 
edge Is equal to lower window 
edge, there Is no more to 
resend. Line Setup configured 
for emulate mode only. 
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Table 80-2 (continued) 


Type 

Variable 

Value (hex/decimal) Meaning 

extern unsigned char 

12 enhance 

0 

normal 



1 

reverse 



4 

low 



5 

reverse low 



8 

blink 



9 

reverse blink 



12/18 

blink low 




Line Setup configured for 
emulate or monitor mode. 

extern unsigned char 

I2_suppres$ 

0 

off 



1 

on 




Line Setup configured for 
emulate or monitor mode. 


Using spreadsheet tokens, the same test needs two CONDITIONS/ACTIONS 
blocks: 

CONDITIONS: DTE BDBCC 
ACTIONS: COUNTER badjacc INC 
' CONDITIONS: DCE BDBCC 
ACTIONS: COUNTER bad bcc INC 

When the user selects DTE or DCE on the first rack of softkeys for Layer 2 
conditions, a second rack appears from which he must select a particular 
frame type. A DTE INFO condition, for example, when translated, includes 
two C variables, one event variable and one status variable: 

{ 

dte_frame && (m_frame_type -= 0) 

) 

In C, the programmer does not need to specify a frame type. To include all 
frames in a condition, use the event variable only: 

CONDITIONS: 

{ 

dte_frame 

) 

2. Emulate mode only. Some events may be detected in emulate mode only. 
The event variables are rcvd J~rame, invalid J~rame, 12_T1, bcc_error, 
nr_error, ns_error, and frame _sent. 

If you try to use one of these variables in monitor mode, you may be 
returned to the main program menu. When you go to the Protocol 
Spreadsheet and search for errors, a message like the following may be 
displayed: "Error 140: Unresolved reference rcvd Jrame." 

When the user selects RCV on the first rack of softkeys for Layer 2 
conditions, a second rack appears from which he must select a particular 
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frame type. When the translator converts a RCV INFO condition into C, it 
will include two C variables, one event variable and one status variable: 


{ 

rcvd _frame && (rcvd Jrame type == 0) 

} 

The C programmer does not have to specify a frame type. To include all 
received frames in a condition, use the event variable only: 

CONDITIONS: 

1 

rcvd _frame 

) 

Error detecting may be accomplished via bcc_error, nrjerror, ns_error, and 
invalid Jrame. These variables equate to the softkey tokens bearing similar 
names. 

One of the emulate-mode .variables monitors an emulate action. The event 
variable frame_sent will not come true until the frame actually has been 
passed to the layer below. 

(B) Status Variables 

Status variables are those in Table 80-2 that do not include event in the Type 
column. Their associated event variables guarantee that they are updated and 
tested. 

The softkey-generated condition for received Info frames is RCV INFO. The C 
version of the same condition should look like this: 

CONDITIONS: 

{ 

rcvd Jrame && (rcvd Jrame type == 0) 

) 

1. Frame characteristics. All status variables in Table 80-2 containing an m_ 
prefix are valid in either emulate or monitor mode: m Jrame jaddr jsapi , 
mjrame_addrtei, m Jrame jiddr_cr, m Jrame jype, m Jrame jcntrljbyte J , 
m Jrame j>f, m Jrame _bcc Jype, m Jrame jxr, and m Jrame ns. 

All status variables in Table 80-2 containing a rcvd_ prefix are valid in 
emulate mode only: rcvd Jrame _addr_sapi, rcvd Jrame jiddrjei, 
rc vdjram e_a ddr_cr, rcvd Jrame Jype, rcvd Jrame _cntrlj>ytej , 
rcvd Jrame j>f, rcvd Jrame J>cc Jype, rcvd Jrame jir, and rcvd Jrame _ns. 

If you try to use an emulate-mode variable in monitor mode, you may be 
returned to the main program menu. When you go to the Protocol 
Spreadsheet and search for errors, a message like the following may be 
displayed: “Error 140: Unresolved reference rcvd Jrame Jype." 
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2. Frame buffers. As BOP frames are received, they are automatically placed 
in IL message buffers to be passed up the layers. Three emulate-mode 
variables provide the user with access to the information in the frame that is 
located beyond the control byte. These variables are rcvd Jrame_buff_seg, 
rcvd Jrame_sdu_offset, and rcvd Jrame_sdu_size. See Section 66.1 for a 
more detailed discussion of the buffer components to which these variables 
refer. 

Make a pointer to an IL buffer by casting rcvd _Jrame_buff_seg as a long, 
shifting it left sixteen bits, adding rcvd _frame_sdu_offset, and casting the 
result to a pointer. Increment the pointer twice (thereby adding two to the 
offset) . 


{ 

unsigned char * ptr; 

ptr = (void *) (((long) rcvd _Jrame_buff_seg « 16) + rcvd _frame_sdu_offsel) ; 
plrf=2; 

) 

It is now pointing at the first byte in the information field. You may 
continue to move through the frame for its entire length, indicated in 
rcvd _frame_sdu_size. 


3. Transmit window. Four related variables test the status of the Layer 2 
window. The particular values of these variables at any given time is not 
significant. What is significant is how they compare to each other. The 
softkey status condition on the left makes the variable comparison on the 
right: 


WINDOW FULL 
WINDOW EMPTY 
WINDOW NOT FULL 
WINDOW NOTEMPTY 
MORE_TO_RESEND 
NO_MORE_TO_RESEND 


!2_currentwindow_edge == l2_upper_window_edge 
12 _current window _edge == 12 Jower _window _edge 
l2_currenl_window_edge /= l2_upper_window_edge 
l2_current_window_edge I = l2_lower_windowjidge 
I2__resend_edge /= l2_lower_window_edge 
I2_resend_edge == 12 Jower _window _edge 


(C) Controlling Protocol Trace Display 

To enhance or suppress particular frames on the Layer 2 Protocol Trace screen 
in emulate or monitor mode, assign a coded value to I2_enhance or I2_suppress. 
The possible values are listed in Table 80-2. To assign a value to either of these 
variables, place the statement in an ACTIONS block. For example, display RNR 
frames in reverse-video and suppress display of invalid frames: 
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CONDITIONS: RCV RNR 
ACTIONS: 

{ 

I2jtnhance = 1; 

} 

CONDITIONS: RCV INVALID 
ACTIONS: 

{ 

I2_suppress = /; 

) 

Check the value of these display-control variables in a CONDITIONS block 

CONDITIONS: RCV INFO 

{ 

I2_enhance == 1 

) 

ACTIONS: 

{ 

I2_enhance = 0; 

} 

or an ACTIONS block: 

CONDITIONS: RCV INFO 
ACTIONS: 

{ 

if(l2_enhance - - 1) 

I2_enhance = 0: 

) 


80.3 Routines 

Use the following routines in emulate mode only. If you try to call one of these 
routines in monitor mode, you will be returned to the main program menu. When 
you go to the Protocol Spreadsheet and search for errors, a message like the 
following will be displayed: “ Error 140: Unresolved reference 12_givejdata." 

(A) Receive 
I2_give_data 

Synopsis 

extern void I2jive_data(); 

Description 

The 12 _give_data routine takes an interlayer message buffer associated with a 
received INFO frame, changes the SDU offset to point to higher-level data, and 
sends a DL_DATA IND primitive up to Layer 3 along with a reference to this 
buffer. The softkey equivalent of this routine is the GIVE_DATA action on the 
Protocol Spreadsheet. 
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Example 

Layer 3 wants access to the line in order to receive and send data. Assuming 
the LAPD personality package is loaded at Layer 2, enter the following program: 

LAYER: 2 

STATE: datallnk 

CONDITIONS: DL_CONNECT REQ 
ACTIONS: DL CONNECT CONF 
CONDITIONS: DLJDATA REQ 
ACTIONS: SEND INFO “((DL_DATA)> " 

CONDITIONS: RCV INFO 
ACTIONS: 

1 

I2_give_data() ; 

) 

(B) Transmit 
resendframe 

Synopsis 

extern void resend _frame(pf, first _or_next); 
unsigned char pf; 
unsigned char first_or_next; 

Description 

The resend Jrame routine will resend either the first or next frame in the 
window with the P/F bit set to a specified value. The softkey equivalent of this 
routine is the (PROTOCL) RESEND action on the Protocol Spreadsheet. 

In puts 

The first parameter is the value of the P/F bit in the frame. It may be set to 
either 0 or 1. 

The second parameter indicates whether the first frame in the window will be 
sent, or whether the next frame in the window will be sent. The first resend 
action will send the first frame in the window regardless of whether first or next 
has been selected. Legal entries are 0 (first) or 1 (next). 
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Example 

Suppose you want to resend the entire transmit window if you receive a REJ 
frame. 


LAYER: 2 

STATE: xfer 

/* Whatever conditions and actions send data precede the following condition. */ 

CONDITIONS: RCV REJ RESP 
ACTIONS: 

{ 

resend _ framefl , 0 ); 

) 

NEXT_STATE: recover 
STATE: recover 

CONDITIONS: FRAME_SENT 
MORE_TO_RESEND 
ACTIONS: 

{ 

resend _Jrame(l,l); 

} 

CONDITIONS: FRAME_SENT 
NO_MORE_TO_RESEND 
NEXT STATE: xfer 


reset_nr 

Synopsis 

extern void reset_nr(); 

Description 

This routine resets the N(R) field in information and supervisory frames to zero. 
The softkey equivalent of this routine is the (PROTOCL) RSET^NR action on the 
Protocol Spreadsheet. 


Example 

When a link is established, reset N(R). 

LAYER: 2 

STATE: reset 

CONDITIONS: ENTER_STATE 
ACTIONS: SEND SABM 
CONDITIONS: RCV UA 
ACTIONS: 


reset _nr(); 

) 


JUL '90 


80-11 




INTERVIEW 7000 Series Advanced Programming : ATLC-1 07-951 -108 


reset_ns 

Synopsis 

extern void reset_ns(); 

Description 

The N(S) field in information frames is reset to zero and the transmit window is 
cleared. The softkey equivalent of this routine is the (PROTOCL) RSETNS action 
on the Protocol Spreadsheet. 

Example 

When a link is established, reset N(S). 

LAYER: 2 

STATE: reset 

CONDITIONS: ENTERSTATE 
ACTIONS: SEND SABM 
CONDITIONS: RCV UA 
ACTIONS: 

< 

reset _ns(): 

} 

send_frame 

Synopsis 

extern void send _frame(il_buffer_number, relay_baton, data _start_off set, transmit _Jrame _ptr); 
unsigned short il_buffer_number; 
unsigned short relay _baton; 
unsigned short data _start _ofJ set; 
struct send_Jrame structure 
{ 

unsigned char sapijype; 
unsigned char teijype; 
unsigned char cr_type; 
unsigned char framejype; 
unsigned char nr^type; 
unsigned char nsjtype; 
unsigned char p_J_type ; 
unsigned char bcc type; 
unsigned char sapi_value; 
unsigned char tei_value; 
unsigned char cntrijbyle; 
unsigned char nr_value; 
unsigned char ns_value; 

); 

struct send Jrame_structure * transmit Jrame _ptr; 

Description 

The send Jrame routine adds a frame-level header to an interlayer message 
buffer and passes the buffer to Layer 1. The softkey equivalent of this routine is 
the SEND action on the Protocol Spreadsheet. 
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I nput? 

The first parameter is the interlayer message buffer number. See Section 
66.3(A), Layer-Independent OSI routines. 

The second parameter is the maintain bit used to hold the buffer while the send 
operation is being performed. See Section 66.3(A). 

The third parameter is the offset from the beginning of the buffer to the start of 
the service data unit. See Section 66.3(A). 

The fourth parameter is a pointer to the frame structure to be sent. For a 
description of sendj'rame_structure see Table 80-1. 

Example 

Send an Info frame containing a canned fox message and a good BCC onto the 
line. 

{ 

static unsigned short il_buffer_number; 
static unsigned short relay_baton; 
static unsigned short data_start_offset; 
struct send frame _structure 
{ 

unsigned char sapijype; 
unsigned char teijype; 
unsigned char cr_type; 
unsigned char framejlype; 
unsigned char nr^type; 
unsigned char ns_type; 
unsigned char p _J_type; 
unsigned char bcc type; 
unsigned char sapi_value; 
unsigned char tei_value; 
unsigned char cntrl byle; 
unsigned char nr_value; 
unsigned char ns value; 

>; 

struct send _Jrame_structure transmit _frame; 
static char transmit_string [] = "{(.FOX'S) ", 

) 

LAYER: 2 

STATE: send_a_frame 

CONDITIONS: KEYBOARD “ ” 

ACTIONS: 

{ 

_get_ii_msg_buff(&il_buffer_number, <&relay_baton); 
_start_HJ>uJfJist(il_buffer_number,&datajtart_offset); 
transmit ^frame.bccjlype = 1; 

_inseri_il_bujf_tistjcnt(ii_bu}fer_number, data _starl joff set , &transmit_string[0] , 
(sizeof(transmit_string) - I)); 

send Jrame(ii buffer number, relay_baton, data_start_offset, &transmitjrame); 

) 
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81 Q.931 Library 


When the Q.931 package is loaded in via the Layer Setup screen, the following external 
variables become available for use by the programmer. Their use on the Protocol Spreadsheet 
is not limited to any particular layer, though normally they belong at Layer 3. 

The variables approximate Q.931 Layer 3 spreadsheet-generated conditions and actions. 

Refer to Section 41 for more detailed explanations of the purposes of specific conditions and 
actions. Sometimes the name of the variable is sufficient for identifying its related spreadsheet 
token. When this is not the case, the information is provided below. 

81.1 Structures 

There are no extern structures associated exclusively with Q.931. 

81.2 Variables 

The variables discussed below apply when the Line Setup menu shows either emulate 
or monitor mode. Emulate mode, however, is not supported by emulate-only 
conditions and actions on the Protocol Spreadsheet. 

(A) Monitoring Events 

Q.931 Layer 3 event variables detect packets on either side of the line. See 
Table 81-1. They are valid in either emulate or monitor mode. The event 
variables are die _packet and dee _packet. 

When the user selects DTE or DCE on the first rack of softkeys for Layer 3 
conditions, a second rack appears from which he must select a particular 
message type. A DTE INFO condition, for example, when translated, includes two 
C variables, one event variable and one status variable: 

{ 

die jacket && (m_m essagejype -- 0x7b ) 

} 

As a C programmer, you do not need to specify a message type. To include all 
DTE messages in a condition, use the event variable only: 

CONDITIONS: 

{ 

die jacket 

) 
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Table 81-1 
Q.931 Variables 


Type 


Variable Value (hex/decimal) Meaning 


extern event 


extern event 


extern volatile const unsigned char 


extern volatile const unsigned char 


extern volatile const unsigned char 


extern volatile const unsigned char 


dtepacket 


dcejjacket 


m_packet_bcc_type 


1 

2 

3 


m_prot_dlsc 


OO-tHO-255 


m_eail_ref_flag 0 

1 


m_message_type_defined 0 


1 


True when a DTE packet Is 
detected. Line Setup 
configured for emulate or 
monitor mode. 

True when a DCE packet Is 
detected. Line Setup 
configured for emulate or 
monitor mode. 

good 

bad 

abort 

Line Setup configured for 
emulate or monitor mode, 

Actual value of protocol 
discriminator— should be 8. Line 
Setup configured for emulate or 
monitor mode. 

origination side 
destination side 

Line Setup configured for 
emulate or monitor mode. 

Actual value received Is not a 
defined value for a LAPD 
message type. 

Actual value received Is one of 
the following valid values for a 
LAPD message type: 


1 

alerting 

2 

call proceeding 

5 

setup 

7 

connect 

d/13 

setup ack 

f/IS 

connect ack 

20/32 

user Info 

21/33 

suspend rej 

22/34 

resume rej 

25/37 

suspend 

26/38 

resume 

2d/45 

suspend ack 

2e/46 

resume ack 

40/84 

detach 

45/69 

disconnect 

48/72 

detach ack 

4d/77 

release 

5a/90 

release complete 

60/96 

cancel 

62/98 

facility 

64/100 

register 

68/104 

cancel ack 

6a/106 

facility ack 

6C/108 

register ack 


(m_message_type_defined continued on next page) 
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Table 81-1 (continued) 


Type 

Variable 

Value (hex/decimal) Meaning 


(mjnessagejypejieUned continued) 

70/112 cancel re) 

72/114 facility rej 

74/116 register re) 

79/121 congestion control 

7b/ 123 Info 

7d/1 25 status 

/ 



Line Setup configured for 
emulate or monitor mode. 

extern volatile const unsigned char 

m_message_type 

00-1 1 10-255 

Actual value of the 
message-type byte. Line Setup 
configured for emulate or 
monitor mode. 

extern volatile const unsigned char 

m_call_refjen 

0-15 

Length of the call-reference 
value field. Line Setup 
configured for emulate or 
monitor mode. 

extern volatile const unsigned char 

mJnfo_element_len 


Length of Information element 
field. The total Includes all 
information elements. Line 
Setup configured for emulate or 
monitor mode. 

extern volatile const unsigned char * 

m_pt r_t o_ca!l_ref 


Pointer to the call-reference 
value field. Begins at the first 
byte, containing the call 
reference length. Line Setup 
configured for emulate or 
monitor mode . 

extern volatile const unsigned char 1 

m_ptr_toJnfo_element 


Pointer to the Information 
element field, Begins at the 
first byte after the 
message-type byte. Line Setup 
configured for emulate or 
monitor mode. 

extern unsigned char 

I3_enhance 

0 

i 

4 

5 
8 
9 

12/18 

normal 

reverse 

low 

reverse low 
blink 

reverse blink 
blink low 




Line Setup configured for 
emulate or monitor mode. 

extern unsigned char 

I3_suppress 

0 

1 

off 

on 




Line Setup configured for 
emulate or monitor mode. 
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(B) Status Variables 

Status variables are those in Table 81-1 that do not include event in the Type 
column. Their associated event variables guarantee that they are updated and 
tested. 

The softkey-generated condition for DTE Info frames is DTE info. The C 
version of the same condition should look like this: 

CONDITIONS: 

{ 

die jacket && (m_mes$age Jtype == 0x7b) 

) \ 

1. Packet characteristics. AH status variables in Table 81-1 containing an 
prefix are valid in either emulate or monitor mode: m jacket _bcc_type , 
m _prot_disc, m_ca!I_ref_len, m_call_refjlag, mjnessagejype, 
m_message_type_defined, and m_info_ele>nentJen. 

2. Pointers. Two pointers provide access to variable-length fields. 
m _ptr_to_call_ref is the pointer to the call-reference field, 

m _ptr _to_info _element is the pointer to the information-element field. 

(C) Controlling Protocol Trace Display 

To enhance or suppress particular packets on the Layer 3 Protocol Trace screen 
in emulate or monitor mode, assign a coded value to I3_enhance or I3_suppress. 
The values are listed in Table 81-1. To assign a value to either of these 
variables, place the statement in an ACTIONS block. For example, display 
Suspend messages in reverse-video and suppress display of Status messages: 

CONDITIONS: DTE SUSPEND 
ACTIONS: 

{ 

13 enhance = 1; 

) 

CONDITIONS: DTE STATUS 
ACTIONS: 

< 

13 suppress - l; 

} 

Check the value of these display-control variables in a CONDITIONS block 

CONDITIONS: DTE INFO 

1 

I3_enhance == 1 

1 

ACTIONS: 

I3_enhance = 0; 

} 
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or an ACTIONS block: 

CONDITIONS: DTE INFO 
ACTIONS: 

{ 

if(l3_enhance == !) 
I3_enhance - 0; 

) 


81.3 Routines 


There are no routines associated exclusively with Q.931. 
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82 SS#7 Layer 2 Library 

When the SS#7 Layer 2 package is loaded in via the Layer Setup screen, most of the 
following external variables become available for use by the programmer. Their use on the 
Protocol Spreadsheet is not limited to any particular layer, though normally they belong at 
Layer 2. 

The SS#7 Layer 1 variables shown in Table 82-2 are accessible only when the Layer 1 
SS7 CMPRESN package is loaded in via the Layer Setup screen. They do not have related 
spreadsheet tokens. These Layer 1 variables are included in this section since they are 
associated with the Layer 2 event variables in Table 82-1. 

The Layer 2 variables approximate SS#7 Layer 2 spreadsheet-generated conditions and 
actions. Refer to Section 45 for more detailed explanations of the purposes of specific 
conditions and actions. Sometimes the name of the variable is sufficient for identifying its 
related spreadsheet token. When this is not the case, the information is provided below. 

82.1 Structures 

There are no extern structures associated exclusively with SS#7. 

82.2 Variables 

The variables discussed below apply when the Line Setup menu shows either emulate 
or monitor mode. Emulate mode, however, is not supported by emulate-only 
conditions and actions on the Protocol Spreadsheet. 

(A) Monitoring Events 

SS#7 Layer 2 events include frames detected, good or bad BCC’s, and aborts. 
All event variables in Table 82-1 containing a dte_ or dce_ prefix are valid in 
either emulate or monitor mode. These event variables are dte Jrame, 
dee J'rame, dte _good_bcc, dce_good_bcc, dte_bad_bcc, dce_bad_bcc, dte_abort, 
dce_abort. 

You can use both dte and dee variables relating to the same event in one 
conditions block. Suppose you want to count all bad BCC's from either side of 
the line. Enter the following CONDITIONS/ACTIONS block: 

CONDITIONS: 

{ 

dle_bad_bcc \ | dce_bad_bcc 

} 

ACTIONS: COUNTER bad_bcc INC 
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Table 82-1 

SS#7 Layer 2 Variables 


Type 

Variable 

Value (hex/decimal) Meaning 

extern event 

dte_frame 


True when a non-suppressed 
DTE frame Is detected. Line 
Setup configured for emulate or 
monitor mode. 

extern event 

dce_frame 


True when a non-suppressed 
DCE frame Is detected. Line 
Setup configured for emulate or 
monitor mode. 

extern event 

dte_good_bcc 


True when a non-suppressed 
good BCC Is calculated for a 
DTE frame. Line Setup 
configured for emulate or 
monitor mode. 

extern event 

dce_good_bcc 


True when a non-suppressed 
good BCC Is calculated for a 
DCE frame. Line Setup 
configured for emulate or 
monitor mode. 

extern event 

dte_bad_bcc 


True when a bad BCC Is 
calculated for a DTE frame. 
Line Setup configured for 
emulate or monitor mode. 

extern event 

dce_bad_bcc 


True when a bad BCC Is 
calculated for a DCE frame. 
Line Setup configured for 
emulate or monitor mode. 

extern event 

dte abort 


True when an abort is detected 
for a DTE frame. Line Setup 
configured for emulate or 
monitor mode. 

extern event 

dce_abort 


True when an abort Is detected 
for a DCE frame, Line Setup 
configured for emulate or 
monitor mode. 

extern volatile const unsigned char 

m unit type 

1 

Fill-in Signal Unit (FI) 


2 

3 

Link Status Signal Unit (LSU) 
Message Signal Unit (MSU) 

Line Setup configured for 
emulate or monitor mode. 

extern volatile const unsigned char 

m_blb 

0 

non-zero 

0 

1 

Line Setup configured for 
emulate or monitor mode. 

extern volatile const unsigned char 

m_flb 

0 

1 

0 

1 


Line Setup configured for 
emulate or monitor mode. 
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Table 82-1 (continued) 


Type 

Variable 

Value (hex/decimal) Meaning 

extern volatile const unsigned char 

m II 

0 

FI 



1-2 

LSU 


— 

3-3fl63 

MSU 




Line Setup configured for 
emulate or monitor mode. 

extern volatile const unsigned char 

m soO 

0 

out of alignment 



1 

normal 



2 

emergency 



3 

out of service 



4 

processor out 



5 

busy 




Line Setup configured for 
emulate or monitor mode. 

extern volatile const unsigned char 

m frame bcc type 

1 

good bcc 



2 

bad bcc 



3 

abort 




Line Setup configured for 
emulate or monitor mode. 

extern unsigned char 

12 enhance 

0 

normal 



1 

reverse 



4 

low 



5 

reverse low 



8 

blink 



9 

reverse blink 



12/18 

blink low 




Line Setup configured for 
emulate or monitor mode. 

extern unsigned char 

I2_suppress 

0 

off 



1 

on 




Line Setup configured for 
emulate or monitor mode. 


When the user selects DTE or DCE on the first rack of softkeys for Layer 2 
conditions, a second rack appears from which he must select a particular frame 
type. A DTE FILLIN condition, for example, when translated, includes two C 
variables, one event variable and one status variable: 

1 

die Jrame && (m_unit_type -= 1) 

} 

The C programmer does not need to specify a frame type. To include all 
frames in a condition, use the event variable only: 

CONDITIONS: 

{ 

die Jrame 

) 
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(B) Status Variables 

Status variables are those in Table 82-1 that do not include event in the Type 
column. Their associated event variables guarantee that they are updated and 
tested. 

The softkey-generated condition for DTE Busy Link Status Signal Unit is DTE 
STATUS= B. The C version of the same condition should look like this: 

CONDITIONS: 

{ 

die Jrame && (m_unitjype -- 2) && ( mjsoO == 5) 

) 

Status variables in Table 82-1 containing an m_ prefix are valid in either emulate 
or monitor mode: m_unit_type, m_bib, m _fib, m_li, m_soO, and 
m Jrame Jyccjype. 

The Layer 1 variables listed in Table 82-2 are also status variables, valid in 
either emulate or monitor mode. Any of the Layer 2 event variables in 
Table 82-1 guarantee that they are updated and tested. 

NOTE: The SS#7 Layer 1 variables are updated frequently. If 
you want to track these variables for statistical purposes, we 
recommend that you copy their values into temporary variables. 


(C) Controlling Protocol Trace Display 

To enhance or suppress particular frames on the Layer 2 Protocol Trace screen 
in emulate or monitor mode, assign a coded value to I2jenhance or I2_suppress. 
The values are listed in Table 82-1. To assign a value to either of these 
variables, place the statement in an ACTIONS block. For example, display only 
Link Signal Units. Of these, display Emergency LSU’s in reverse-video. 

CONDITIONS: 

{ 

dte Jrame && (m_unil type != 2) 

) 

ACTIONS: 

{ 

12 suppress = I; 

) 

CONDITIONS: 

{ 

die Jrame && (m_unit type == 2) && (m_soO -- 2) 

} 

ACTIONS: 

{ 

I2_enhance = 1; 

) 
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Table 62-2 

SS#7 Layer 1 Variables 


Type 

Variable 

Value (hex/decimal) Meaning 

extern unsigned short 

dte_frames_suppressed 

Number of DTE Fill-In or Link 
Status Signal Units suppressed 
since the last non-suppressed 
frame. Line Setup configured 
for emulate or monitor mode. 

extern unsigned short 

dce_frames_suppressed 

Number of DCE Fill-In or Link 
Status Signal Units suppressed 
since the last non-suppressed 
frame. Line Setup configured 
for emulate or monitor mode. 

extern unsigned short 

dte_flags 

Number of DTE flags received 
since the last non-suppressed 
frame. Line Setup configured 
for emulate or monitor mode. 

extern unsigned short 

dce_flags 

Number of DCE flags received 
since the last non-suppressed 
frame, Line Setup configured 
for emulate or monitor mode. 


Check the value of these display-control variables in a CONDITIONS block 

CONDITIONS: 

{ 

dte^frame && (m_unit_type == 2) && (m_soO == 2) && (I2_enhance == 0) 

) 

ACTIONS: 

{ 

!2_enhance = 1; 

} 

or an ACTIONS block: 

CONDITIONS: 

< 

dte_frame && (m_unit type -- 2) && (m_soO == 2) 

) 

ACTIONS: 

{ 

if(l2_enhance == 0) 

I2_enhance = 1; 

) 


82.3 Routines 

There are no routines associated exclusively with SS07. 
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83 SS#7 Layer 3 Library 


When the SS#7 Layer 3 package is loaded in via the Layer Setup screen, the following 
external variables become available for use by the programmer, Their use on the Protocol 
Spreadsheet is not limited to any particular layer, though normally they belong at Layer 3. 

The variables approximate SS#7 Layer 3 spreadsheet-generated conditions and actions. Refer 
to Section 46 for more detailed explanations of the purposes of specific conditions and 
actions. Sometimes the name of the variable is sufficient for identifying its related spreadsheet 
token. When this is not the case, the information is provided below. 


83.1 Structures 

There are no extern structures associated exclusively with SS#7 . 

83.2 Variables 

The variables discussed below apply when the Line Setup menu shows either emulate 
or monitor mode. Emulate mode, however, is not supported by emulate-only 
conditions and actions on the Protocol Spreadsheet. 

(A) Monitoring Events 

SS#7 Layer 3 event variables detect Message Signal Units on either side of the 
line. See Table 83-1. They are valid in either emulate or monitor mode. The 
event variables are die _packet and dee _paeket. 

When the user selects DTE or DCE on the first rack of softkeys for Layer 3 
conditions, a second rack appears from which he must select a particular MSU 
type. A DTE NETM condition, for example, when translated, includes two C 
variables, one event variable and one status variable: 

{ 

die jacket && (m_sio_si == 0) 

> 

As a C programmer, you do not have to specify an MSU type. To include all 
DTE Message Signal Units in a condition, use the event variable only: 

CONDITIONS: 

{ 

die jacket 

} 
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Table 83-1 

SS#7 Layer 3 Variables 


Type 

Variable 

Value (hex/decimal) Meaning 

extern event 

dce_packet 


True when a DCE packet Is 
detected. Line Setup 
configured for emulate or 
monitor mode. 

extern event 

dte_packet 


True when a DTE packet Is 
detected. Line Setup 
configured for emulate or 
monitor mode. 

extern volatile const unsigned char 

m slo nl 

0 

International 0 



40/64 

International 1 



80/128 

national 0 



cO/192 

national 1 




Line Setup configured for 
emulate or monitor mode. 

extern volatile const unsigned char 

m slo priority 

0 

prlorlty=0 



10/16 

prlorlty=1 



20/32 

prlorlty=2 



30/48 

prlority=3 

Line Setup configured for 
emulate or monitor mode. 

extern volatile const unsigned char 

m_slo_s! 

0-7 

User Part: 



0 

netm 



1 

ntr 



2 

nts 



3 

seep 



4 

tup 



5 

Isdn 



6 

dupO 



7 

dupl 



8-118-15 

spare 




Line Setup configured for 
emulate or monitor mode. 

extern volatile const unsigned ohar 

m_code_type 


(high 4 bits not defined) 



1 

Itm 



2 

Ita 


(m code type continued on next page) 



t The high four bits In test headers are not defined. To check the value of m_code_type for test headers, and 
m_code_type with OxOf: 

header = m_code_type & 0x0 1; 

For LTM's, header equals 1; for LTA's. header equals 2. 
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Table 83-1 (continued) 


Type 


Variable Value (hex/decimal) Meaning 


( m_code_type continued) 


SCCP headers : 


1 

cr 

2 

cc 

3 

cr ef 

4 

rlsd 

5 

rlc 

6 

dt 1 

7 

dt2 

8 

ak 

9 

udt 

a/10 

udts 

b/1 1 

ed 

c/12 

ea 

d/13 

rsr 

e/14 

rsc 

f/15 

err 

10/16 

it 


NETM headers : 


11/17 

12/18 

13/19 

14/20 

15/21 

15/21 

16/22 

18/24 

21/33 

22/34 

23/35 

24/36 

25/37 

25/37 

26/38 

28/40 

34/52 

35/53 

36/54 

38/56 

44/68 

45/69 

46/70 

48/72 

51/81 

54/84 

56/86 

61/96 

64/100 

66/102 

76/118 

86/134 


coo 

eco 

ret 

tfp 

rsp (US format only) 

rst (CCITT format only) 

lln 

die 

coa 

eca 

tfc 

top (US format only) 

rsr (US format only) 

rst (CCITT format only, national 

option) 

lun 

css 

tfr 

rep (US format only) 

lla 

ens 

ter (US format only) 

rcr (US format only) 

lua 

enp 

cbd 

tfa 

lid 

eba 

tea (US format only) 

Ifu 

III 

Irl 


(m_code_type continued on next page) 
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Table 83-1 

(continued) 


Type 

Variable 

Value (hex/decimal) 

Meaning 


(m_code_type continued ) 


TUP headers: 


6 

anil 


10 

reserved 


11/17 

lam 


12/18 

gsm 


13/19 

grq 


14/20 

acm 


15/21 

sec 


16/22 

anc 


17/23 

rig 


18/24 

mgb 


19/25 

cfm 


21/33 

lal 


24/36 

chg 


25/37 

cgc 


26/38 

ann 


27/39 

bio 


28/40 

mba 


29/41 

cpm 


31/49 

sam 


32/50 

cot 


35/53 

nnc 


36/54 

cbk 


37/55 

bla 


38/56 

mgu 


39/57 

cpa 


41/65 

sao 


42/66 

ccf 


45/69 

adl 


46/70 

elf 


47/71 

ubl 


48/72 

mua 


49/73 

CSV 


55/85 

cfl 


56/86 

ran 


57/87 

uba 


58/88 

hgb 


59/89 

cvm 


65/101 

ssb 


66/102 

fot 


67/103 

ccr 


68/104 

hba 


69/105 

crm 


75/117 

unn 


76/118 

ccl 


77/119 

rsc 


78/120 

hgu 


79/121 

ell 


85/133 

los 


88/136 

hua 


(m_code_type continued on next page) 
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Table 83-1 (continued) 


Type 


Variable Value (hex/decimal) Meaning 


(m_code_type continued) 


(TUP headers continued) 


95/149 sst 

98/152 grs 

a5/1S5 acb 

a8/168 gra 

b5/1 81 dpn 

b8/104 sgb 

c5/197 mpr 

cS/200 sba 

d8/216 sgu 

e0/232 sua 

fS/245 eum 

f6/246 earn 


ISDN headers : 


1 ■ 

2 

3 

4 

5 

6 
0 
9 

a/10 
b/1 1 
d/12 
e/14 
f/15 
10/16 
11/17 
12/18 
13/19 
14/20 
15/21 
16/22 
17/23 
18/24 
19/25 
1a/26 
lb/27 
1c/28 
1 d/29 
1e/30 
If/31 
20/32 
21/33 
22/34 
23/35 
25/37 
26/38 
27/39 
28/40 
29/41 


lam 

sam 

Inr 

Inf 

cot 

acm 

fot 

anm 

ubm 

re I 

pau 

res 

rlsd 

rlc 

ccr 

rsc 

bio 

ubl 

bla 

uba 

grs 

cgb 

cgu 

cgba 

cgua 

cmr 

cmc 

rcm 

far 

faa 

fr] 

fad 

fal 

osvr 

csvs 

drs 

pam 

gra 

Line Setup configured for 
emulate or monitor mode. 
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Table 83-1 (continued) 


Type 

Variable 

Value (hex/decimal) Meaning 

extern volatile unsigned long 

m label dpc 

0 - 3 /m 




0-16383 

O-ftf/td 

CCITT format (2 bytes) 



0-16777215 

ANSI format (3 bytes) 




Line Setup configured for 
emulate or monitor mode. 

extern volatile unsigned long 

mJabel_opc 

0-3/ffl 

0-16383 

0-ftfftfl 

CCITT format (2 bytes) 



0-16777215 

ANSI format (3 bytes) 




Line Setup configured for 
emulate or monitor mode. 

extern volatile const unsigned char 

m label sis 

0-//0-1 5 

CCITT format 


0-1/10-31 

ANSI format 




Line Setup configured for 
emulate or monitor mode. 

extern volatile unsigned short 

m clc 

0-1(1/0-409 5 

TUP MSUs 



0-ft(f 10-65535 

ISDN MSUs 




Line Setup configured for 
emulate or monitor mode. 

extern unsigned char 

13 enhance 

0 

normal 



1 

reverse 



4 

low 



5 

reverse low 



e 

blink 



9 

reverse blink 



12/18 

blink low 




Line Setup configured for 
emulate or monitor mode. 

extern unsigned char 

I3_suppress 

0 

off 



1 

on 




Line Setup configured for 
emulate or monitor mode. 


(B) Status Variables 

Status variables are those in Table 83-1 that do not include event in the Type 
column. Their associated event variables guarantee that they are updated and 
tested. 

The softkey-generated condition for NETM Message Signal Units on the DTE 
side of the line is DTE NETM. The C version of the same condition should look 
like this: 

CONDITIONS: 

{ 

die _packet && (m sio si == 0) 

} 
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Most status variables in Table 83-1 contain an m_ prefix: m_sio_ni, 

m_sio __ priority , m_sio_si, m_code_type, m_label_dpc, m_label_opc, mjabeljsls, 

and m cic. 


(C) Controlling Protocol Trace Display 

To enhance or suppress particular packets on the Layer 3 Protocol Trace screen 
in emulate or monitor mode, assign a coded value to I3_enhance or 13 _suppress. 
The values are listed in Table 83-1. To assign a value to either of these 
variables, place the statement in an ACTIONS block. For example, display only 
messages with NETM headers. Of these, display Transfer Restricted headers in 
reverse-video. 

CONDITIONS: 

{ 

dte jacket <£<4 (m_sio_si I- 0) 

) 

ACTIONS: 

{ 

I3_suppress = 1; 

} 

CONDITIONS: 

{ 

dte jacket <&& (m sio_si == 0 ) &<& (mcodejype == 0x34) 

) 

ACTIONS: 

{ 

I3jnhance = /; 

) 

Check the value of these display-control variables in a CONDITIONS block 

CONDITIONS: 

{ 

dte jacket && (m_sio_si != 0) && (I2_suppress == 0) 

) 

ACTIONS: 

1 

I2_suppress = I; 

) 

or an ACTIONS block: 

CONDITIONS: 

{ 

dte jacket <k& (m_sio_si != 0) 

} 

ACTIONS: 

{ 

if(l2_suppress == 0 ) 

I2_suppress - 1; 

) 
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83.3 Routines 

There are no routines associated exclusively with SS#7. 
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